Endpoint : https://glytoucan.org/api/submission/:format/:submission_number
wurcs or glycoctBasic Authentication over HTTPS is used to transfer the user authentication information.
How basic authentication is handled depends upon the tool being used, for curl, it is the -u parameter.
curl -u <Contributor ID>:<API Key> https://glytoucan.org/api/submission/wurcs/<Submission Number>
Previously, submission data from all users (including duplicate glycan structures) was stored in the RDF. As of v4, each user can retrieve only their own submission data via their API key.
Public data can also be accessed via SPARQL. For more information, please refer to the GlyTouCan RDF page.
{
"errcode": "",
"contents": {
"inputtext": "WURCS=2.0/4,13,12/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5][a2112h-1a_1-5]/1-1-2-3-3-3-4-3-3-3-3-3-4/a4-b1_b4-c1_c3-d1_c6-h1_d2-e1_e2-f1_e3-g1_h3-i1_h6-k1_i2-j1_k2-l1_m1-j2|l2}",
"submission_date": "2019-10-01T07:02:21.000806",
"submission_log": "Migrated from GlyTouCan v3",
"submission_number": "51ea5de58c63c09833e148cb7103e2ad5c1e239a364be11ba87d6b95b2ae1e73",
"accession": "G27803IM",
"validated_wurcstext": "WURCS=2.0/4,13,12/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5][a2112h-1a_1-5]/1-1-2-3-3-3-4-3-3-3-3-3-4/a4-b1_b4-c1_c3-d1_c6-h1_d2-e1_e2-f1_e3-g1_h3-i1_h6-k1_i2-j1_k2-l1_m1-j2|l2}",
"validation_date": "2026-06-10T09:49:06.000314",
"validation_error": "",
"validation_log": "",
"validation_unverifiable": "",
"validation_warning": ""
},
"logs": {
"url": "http://glytoucan.org/api/submission/wurcs/51ea5de58c63c09833e148cb7103e2ad5c1e239a364be11ba87d6b95b2ae1e73"
}
}
Error codes are planned to be added as needed, but are not yet defined. The same applies to the errcode field in the other API on this page.
Endpoint : https://glytoucan.org/api/entry/:accession
https://glytoucan.org/api/entry/G27803IM
{
"errcode": "",
"contents": {
"accession": "G27803IM",
"accession_date": "2019-08-14T04:18:32.000644",
"validated_wurcstext": "WURCS=2.0/4,13,12/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5][a2112h-1a_1-5]/1-1-2-3-3-3-4-3-3-3-3-3-4/a4-b1_b4-c1_c3-d1_c6-h1_d2-e1_e2-f1_e3-g1_h3-i1_h6-k1_i2-j1_k2-l1_m1-j2|l2}"
},
"logs": {
"url": "http://glytoucan.org/api/entry/G27803IM"
}
}
Searching for an archived ID returns a response like the following:
{
"errcode": "",
"contents": {
"archive_flag": true,
"public_accession": "G88485AW"
},
"logs": {
"url": "http://glytoucan.org/api/entry/G68622UR"
}
}
Note that a public_accession is not necessarily present.
Endpoint : https://glytoucan.org/api/entry/search
curl -X POST -H 'Content-Type: application/json' -d '{ "sequence": "<WURCS Sequence>" }' https://glytoucan.org/api/entry/search
{
"errcode": "",
"contents": {
"accession": "G27803IM",
"accession_date": "2019-08-14T04:18:32.000644",
"validated_wurcstext": "WURCS=2.0/4,13,12/[a2122h-1b_1-5_2*NCC/3=O][a1122h-1b_1-5][a1122h-1a_1-5][a2112h-1a_1-5]/1-1-2-3-3-3-4-3-3-3-3-3-4/a4-b1_b4-c1_c3-d1_c6-h1_d2-e1_e2-f1_e3-g1_h3-i1_h6-k1_i2-j1_k2-l1_m1-j2|l2}"
},
"logs": {
"url": "http://glytoucan.org/api/entry/search"
}
}
Endpoint : https://glytoucan.org/api/archive/list
https://glytoucan.org/api/archive/list
{
"errcode": "",
"contents": [
{
"archive_accession": "G68622UR",
"archive_accession_date": "2026-03-03T08:01:22.000907",
"public_accession": "G88485AW",
"archive_date": "2026-03-03T08:01:22.000977",
"archive_log": "Migrated from GlyTouCan v3"
},
{
"archive_accession": "G48814DZ",
"archive_accession_date": "2026-03-03T08:01:23.000001",
"public_accession": "G31454ZO",
"archive_date": "2026-03-03T08:01:23.000057",
"archive_log": "Migrated from GlyTouCan v3"
},
// ... (truncated)
{
"archive_accession": "G88451HM",
"archive_accession_date": "2017-09-12T18:53:36.000631",
"public_accession": "G38084GX",
"archive_date": "2026-06-12T03:53:25.000946",
"archive_log": "Archived for GlyTouCan v4"
},
{
"archive_accession": "G39690UO",
"archive_accession_date": "2017-09-12T18:53:36.000189",
"public_accession": "G59617SM",
"archive_date": "2026-06-12T03:53:25.000947",
"archive_log": "Archived for GlyTouCan v4"
}
],
"logs": {
"url": "http://glytoucan.org/api/archive/list"
}
}
Note that some of the accessions in the response have simply been archived without a public_accession.