EBI Ontology Lookup Service
App · 12 actions
Search and browse about 290 biomedical ontologies in EMBL-EBI's Ontology Lookup Service (OLS): the Gene Ontology, ChEBI, EFO, the Human Phenotype Ontology, MONDO, Uberon, NCIT and more. Find terms by name or synonym, map free text to its best term, look a term up by its id (definition, synonyms, cross-references, obsolete or replaced), walk its parents, children, ancestors, descendants and paths to the root, list its other relationships, and see each ontology's version, size and licence. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Get a term | Look a term up by its id, IRI or OLS link: its label, definition, synonyms, cross-references to other vocabularies (MeSH, ICD-10, UMLS...), older ids, whether it is obsolete and what replaced it, and every annotation. |
| Get a term's paths to the root | Get every chain of is a links from the top of the ontology down to a term, as text (entity > disease > ... |
| Get an ontology | Get one ontology's title, description, version, licence, number of terms, properties and individuals, when OLS last loaded it, its top-level terms, the ontologies it imports, papers to cite and where it is maintained. |
| List a term's children | List the narrower terms under a term: its direct children, or all its descendants, by is a links or with part of too. |
| List a term's parents | List the broader terms above a term: its direct parents, or all its ancestors up to the root, by is a links or with part of too. |
| List a term's relationships | List a term's links to other terms beyond its place in the hierarchy: part of, has part, develops from, produces, regulates and the rest, with the term at the other end. |
| List an ontology's terms | List every term of an ontology a page at a time, imported ones and obsolete ones included, each with its definition and synonyms: for copying a vocabulary into a spreadsheet or database. |
| List an ontology's top-level terms | List the terms at the top of an ontology, such as GO's molecular function, cellular component and biological process: the ones the ontology names as its roots, else its own terms without a parent, or every term without a parent. |
| List ontologies | List the ontologies OLS holds, or those matching a search: each one's id, title, version, number of terms, licence and when OLS last loaded it. |
| Map text to a term | Find the term that best fits a piece of text, such as a disease typed into a form: a term with that label first, then one with it as a synonym, then OLS's closest match. |
| Search terms | Search for terms by name, synonym, definition or id, across every ontology in OLS or only in some: each match's id, label, ontology, description and synonyms. |
| Suggest labels | Complete what someone has started typing with term labels and synonyms, for autocomplete: 'diabetes mel' gives diabetes mellitus and its kin. |
Get a term
Look a term up by its id, IRI or OLS link: its label, definition, synonyms, cross-references to other vocabularies (MeSH, ICD-10, UMLS...), older ids, whether it is obsolete and what replaced it, and every annotation. An id OLS doesn't know comes back with 'found' false.
Inputs
- Term
termtextRequired - The term's id, such as GO:0006915 or HP:0001250, its IRI, or a link to its OLS page. 'Search terms' or 'Map text to a term' find one by name.
- Ontology
ontologytext - The ontology to read the term in. Leave empty for the ontology that defines it; pick another to see the term as that ontology imports it.
Outputs
alternative_idslist- Older ids merged into this term, which still lead to it.
annotationsobject- Every other annotation OLS holds, by name, each a list of texts: such as has_obo_namespace, UMLS_CUI or has exact match.
considerlist- Terms an obsolete one suggests considering instead, when there is no single replacement.
cross_referenceslist- The same thing in other databases and vocabularies (MeSH, ICD-10, UMLS, Wikipedia...).
definitiontext- The term's definition.
descriptionslist- Every description OLS holds: the definition, and any comments.
foundtrue/false- True when OLS has the term. False when it doesn't, and the rest is empty.
has_childrentrue/false- True when the term has narrower terms under it.
idtext- The term's id, such as GO:0006915: its OBO id where it has one. Every Term field takes it.
iritext- The term's IRI, such as http://purl.obolibrary.org/obo/GO_0006915: its permanent, unique name.
is_defining_ontologytrue/false- True when this ontology defines the term; false when it imports it.
is_obsoletetrue/false- True when the term is obsolete: annotate with 'replaced_by' instead.
is_roottrue/false- True when the term has no parent.
labeltext- The term's name, such as apoptotic process.
ontology_idtext- The id of the ontology it is in, such as go.
ontology_prefixtext- The ontology's prefix, such as GO.
replaced_byobject- The term to use instead of an obsolete one, when the ontology names one.
short_formtext- The term's short form, such as GO_0006915.
subsetslist- The ontology subsets (slims) the term is in.
summarytext- One line saying what was found.
synonymslist- Other names for the term.
urltext- The term's page on the OLS site.
Example output
{
"alternative_ids": [
"GO:0006917",
"GO:0008632"
],
"annotations": {
"database_cross_reference": [
"Wikipedia:Apoptosis",
"Reactome:R-HSA-109581"
],
"has_alternative_id": [
"GO:0006917",
"GO:0008632"
],
"has_obo_namespace": [
"biological_process"
]
},
"consider": [],
"cross_references": [
{
"database": "Wikipedia",
"description": null,
"id": "Wikipedia:Apoptosis",
"url": "http://en.wikipedia.org/wiki/Apoptosis"
},
{
"database": "Reactome",
"description": "Apoptosis",
"id": "Reactome:R-HSA-109581",
"url": "https://www.reactome.org/content/detail/R-HSA-109581"
}
],
"definition": "A programmed cell death process which begins when a cell receives an internal (e.g. DNA damage) or external signal (e.g. an extracellular death ligand), and proceeds through a series of biochemical events (signaling pathway phase) which trigger an execution phase. The execution phase is the last step of an apoptotic process, and is typically characterized by rounding-up of the cell, retraction of pseudopodes, reduction of cellular volume (pyknosis), chromatin condensation, nuclear fragmentation (karyorrhexis), plasma membrane blebbing and fragmentation of the cell into apoptotic bodies. When the execution phase is completed, the cell has died.",
"descriptions": [
"A programmed cell death process which begins when a cell receives an internal (e.g. DNA damage) or external signal (e.g. an extracellular death ligand), and proceeds through a series of biochemical events (signaling pathway phase) which trigger an execution phase. The execution phase is the last step of an apoptotic process, and is typically characterized by rounding-up of the cell, retraction of pseudopodes, reduction of cellular volume (pyknosis), chromatin condensation, nuclear fragmentation (karyorrhexis), plasma membrane blebbing and fragmentation of the cell into apoptotic bodies. When the execution phase is completed, the cell has died."
],
"found": true,
"has_children": true,
"id": "GO:0006915",
"iri": "http://purl.obolibrary.org/obo/GO_0006915",
"is_defining_ontology": true,
"is_obsolete": false,
"is_root": false,
"label": "apoptotic process",
"ontology_id": "go",
"ontology_prefix": "GO",
"replaced_by": null,
"short_form": "GO_0006915",
"subsets": [],
"summary": "apoptotic process (GO:0006915) in go",
"synonyms": [
"activation of apoptosis",
"apoptosis activator activity",
"apoptosis signaling",
"apoptosis",
"apoptotic programmed cell death"
],
"url": "https://www.ebi.ac.uk/ols4/ontologies/go/classes?iri=http%3A%2F%2Fpurl.obolibrary.org%2Fobo%2FGO_0006915"
}Get a term's paths to the root
Get every chain of is a links from the top of the ontology down to a term, as text (entity > disease > ... > the term) and as terms, shortest first. A term with several parents has several paths.
Inputs
- Term
termtextRequired - The term's id, such as GO:0006915 or HP:0001250, its IRI, or a link to its OLS page. 'Search terms' or 'Map text to a term' find one by name.
- Ontology
ontologytext - The ontology to read the term in. Leave empty for the ontology that defines it; pick another to see the term as that ontology imports it.
Outputs
countnumber- How many are listed here.
foundtrue/false- True when OLS has the term. False when it doesn't, and the rest is empty.
ontology_idtext- The id of the ontology it is in, such as go.
path_countnumber- How many distinct paths there are in all.
pathslist- Each path from a root down to the term, shortest first.
rootslist- The root terms the paths start from.
shortest_depthnumber- How many steps the shortest path takes from the root to the term.
summarytext- One line saying what was found.
termobject- The term the step was about, as OLS has it.
truncatedtrue/false- True when there were more paths than are listed (at most 100).
Example output
{
"count": 2,
"found": true,
"ontology_id": "mondo",
"path_count": 3,
"paths": [
{
"depth": 11,
"path": "entity > continuant > specifically dependent continuant > realizable entity > disposition > disease > human disease > disease by developmental or physiological process > metabolic disease > glucose metabolism disease > diabetes mellitus > type 2 diabetes mellitus",
"terms": [
{
"id": "BFO:0000001",
"iri": "http://purl.obolibrary.org/obo/BFO_0000001",
"label": "entity"
},
{
"id": "BFO:0000002",
"iri": "http://purl.obolibrary.org/obo/BFO_0000002",
"label": "continuant"
},
{
"id": "BFO:0000020",
"iri": "http://purl.obolibrary.org/obo/BFO_0000020",
"label": "specifically dependent continuant"
},
{
"id": "BFO:0000017",
"iri": "http://purl.obolibrary.org/obo/BFO_0000017",
"label": "realizable entity"
},
{
"id": "BFO:0000016",
"iri": "http://purl.obolibrary.org/obo/BFO_0000016",
"label": "disposition"
},
{
"id": "MONDO:0000001",
"iri": "http://purl.obolibrary.org/obo/MONDO_0000001",
"label": "disease"
},
{
"id": "MONDO:0700096",
"iri": "http://purl.obolibrary.org/obo/MONDO_0700096",
"label": "human disease"
},
{
"id": "MONDO:7770007",
"iri": "http://purl.obolibrary.org/obo/MONDO_7770007",
"label": "disease by developmental or physiological process"
},
{
"id": "MONDO:0005066",
"iri": "http://purl.obolibrary.org/obo/MONDO_0005066",
"label": "metabolic disease"
},
{
"id": "MONDO:0002908",
"iri": "http://purl.obolibrary.org/obo/MONDO_0002908",
"label": "glucose metabolism disease"
},
{
"id": "MONDO:0005015",
"iri": "http://purl.obolibrary.org/obo/MONDO_0005015",
"label": "diabetes mellitus"
},
{
"id": "MONDO:0005148",
"iri": "http://purl.obolibrary.org/obo/MONDO_0005148",
"label": "type 2 diabetes mellitus"
}
]
},
{
"depth": 12,
"path": "entity > continuant > specifically dependent continuant > realizable entity > disposition > disease > human disease > disease by body system or component > digestive system disorder > pancreas disorder > endocrine pancreas disorder > diabetes mellitus > type 2 diabetes mellitus",
"terms": [
{
"id": "BFO:0000001",
"iri": "http://purl.obolibrary.org/obo/BFO_0000001",
"label": "entity"
},
{
"id": "BFO:0000002",
"iri": "http://purl.obolibrary.org/obo/BFO_0000002",
"label": "continuant"
},
{
"id": "BFO:0000020",
"iri": "http://purl.obolibrary.org/obo/BFO_0000020",
"label": "specifically dependent continuant"
},
{
"id": "BFO:0000017",
"iri": "http://purl.obolibrary.org/obo/BFO_0000017",
"label": "realizable entity"
},
{
"id": "BFO:0000016",
"iri": "http://purl.obolibrary.org/obo/BFO_0000016",
"label": "disposition"
},
{
"id": "MONDO:0000001",
"iri": "http://purl.obolibrary.org/obo/MONDO_0000001",
"label": "disease"
},
{
"id": "MONDO:0700096",
"iri": "http://purl.obolibrary.org/obo/MONDO_0700096",
"label": "human disease"
},
{
"id": "MONDO:7770006",
"iri": "http://purl.obolibrary.org/obo/MONDO_7770006",
"label": "disease by body system or component"
},
{
"id": "MONDO:0004335",
"iri": "http://purl.obolibrary.org/obo/MONDO_0004335",
"label": "digestive system disorder"
},
{
"id": "MONDO:0002356",
"iri": "http://purl.obolibrary.org/obo/MONDO_0002356",
"label": "pancreas disorder"
},
{
"id": "MONDO:0001933",
"iri": "http://purl.obolibrary.org/obo/MONDO_0001933",
"label": "endocrine pancreas disorder"
},
{
"id": "MONDO:0005015",
"iri": "http://purl.obolibrary.org/obo/MONDO_0005015",
"label": "diabetes mellitus"
},
{
"id": "MONDO:0005148",
"iri": "http://purl.obolibrary.org/obo/MONDO_0005148",
"label": "type 2 diabetes mellitus"
}
]
}
],
"roots": [
{
"id": "BFO:0000001",
"iri": "http://purl.obolibrary.org/obo/BFO_0000001",
"label": "entity"
}
],
"shortest_depth": 11,
"summary": "3 paths from type 2 diabetes mellitus (MONDO:0005148) to the root of mondo, the shortest 11 steps",
"term": {
"id": "MONDO:0005148",
"iri": "http://purl.obolibrary.org/obo/MONDO_0005148",
"label": "type 2 diabetes mellitus",
"ontology_id": "mondo"
},
"truncated": true
}Get an ontology
Get one ontology's title, description, version, licence, number of terms, properties and individuals, when OLS last loaded it, its top-level terms, the ontologies it imports, papers to cite and where it is maintained. One OLS doesn't have comes back with 'found' false.
Inputs
- Ontology
ontologytextRequired - The ontology: pick one, or type its id, such as go or mondo.
Outputs
descriptiontext- What the ontology covers.
domaintext- The field it covers, such as health or anatomy.
foundtrue/false- True when OLS has the ontology. False when it doesn't, and the rest is empty.
homepagetext- The ontology's home page.
idtext- The ontology's id in OLS, such as go. Every Ontology field takes it.
imports_fromlist- The ids of the ontologies it imports terms from.
languageslist- The languages its labels are in, such as en.
last_loadedtext- When OLS last loaded it, as YYYY-MM-DDTHH:MM:SS (UTC).
licenceobject- The licence the ontology is published under, as OLS records it. Check it before reusing the ontology's content.
number_of_individualsnumber- How many individuals it has.
number_of_propertiesnumber- How many properties (relations) it has.
number_of_termsnumber- How many terms (classes) it has.
ontology_iritext- The ontology's own IRI.
preferred_root_termslist- The top-level terms the ontology names as its own roots.
prefixtext- The prefix of its term ids, such as GO.
publicationslist- Papers to cite for the ontology.
repositorytext- Where its source is kept, such as a GitHub repository.
statustext- Whether it is maintained: active, inactive or orphaned.
summarytext- One line saying what was found.
tagslist- Topics the ontology is tagged with.
titletext- The ontology's name, such as Gene Ontology.
trackertext- Where to report a problem or request a term.
urltext- The ontology's page on the OLS site.
versiontext- The version OLS has loaded, such as 2026-07-26 or 3.95.0.
version_iritext- The IRI of the version loaded.
Example output
{
"description": "An ontology for describing the function of genes and gene products",
"domain": "biological systems",
"found": true,
"homepage": "http://geneontology.org/",
"id": "go",
"imports_from": [
"bfo",
"bspo",
"chebi",
"cl",
"cob",
"dc"
],
"languages": [
"en"
],
"last_loaded": "2026-10-25T00:09:08",
"licence": {
"name": "CC BY 4.0",
"recorded": true,
"statement": null,
"url": "https://creativecommons.org/licenses/by/4.0/"
},
"number_of_individuals": 48,
"number_of_properties": 484,
"number_of_terms": 85169,
"ontology_iri": "http://purl.obolibrary.org/obo/go/extensions/go-plus.ofn",
"preferred_root_terms": [
{
"id": "GO:0003674",
"iri": "http://purl.obolibrary.org/obo/GO_0003674",
"label": "molecular_function"
},
{
"id": "GO:0005575",
"iri": "http://purl.obolibrary.org/obo/GO_0005575",
"label": "cellular_component"
},
{
"id": "GO:0008150",
"iri": "http://purl.obolibrary.org/obo/GO_0008150",
"label": "biological_process"
}
],
"prefix": "GO",
"publications": [
{
"title": "Gene ontology: tool for the unification of biology. The Gene Ontology Consortium",
"url": "https://www.ncbi.nlm.nih.gov/pubmed/10802651"
},
{
"title": "The Gene Ontology resource: enriching a GOld mine",
"url": "https://www.ncbi.nlm.nih.gov/pubmed/33290552"
}
],
"repository": "https://github.com/geneontology/go-ontology",
"status": "active",
"summary": "Gene Ontology (go), version 2026-07-26, 85,169 terms, CC BY 4.0",
"tags": [
"biology"
],
"title": "Gene Ontology",
"tracker": "https://github.com/geneontology/go-ontology/issues/",
"url": "https://www.ebi.ac.uk/ols4/ontologies/go",
"version": "2026-07-26",
"version_iri": "http://purl.obolibrary.org/obo/go/releases/2026-07-26/extensions/go-plus.ofn"
}List a term's children
List the narrower terms under a term: its direct children, or all its descendants, by is a links or with part of too. Useful to expand a term into every kind of it, such as every form of diabetes.
Inputs
- Term
termtextRequired - The term's id, such as GO:0006915 or HP:0001250, its IRI, or a link to its OLS page. 'Search terms' or 'Map text to a term' find one by name.
- Ontology
ontologytext - The ontology to read the term in. Leave empty for the ontology that defines it; pick another to see the term as that ontology imports it.
- How far
depthtext - Direct children only, or every descendant at every level.One of:
direct(Direct children only),all(All descendants). Default:direct. - Links to follow
relationstext - Subclass (is a) links only, or part of, develops from and the other links the ontology treats as hierarchical too.One of:
is_a(Subclass links only (is a)),hierarchical(Subclass and part of links (is a, part of, develops from)). Default:is_a. - Most rows
limitnumber - The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default:
100. - Page
pagenumber - Which page of results to return, from 1.From 1 to 100000. Default:
1.
Outputs
countnumber- How many are listed here.
depthtext- direct (one level) or all (every level).
foundtrue/false- True when OLS has the term. False when it doesn't, and the rest is empty.
has_moretrue/false- True when there are more on later pages.
ontology_idtext- The id of the ontology it is in, such as go.
pagenumber- Which page this is, from 1.
relationstext- is_a (subclass links) or hierarchical (part of and the like too).
summarytext- One line saying what was found.
termobject- The term the step was about, as OLS has it.
termslist- The terms, in OLS's order.
totalnumber- How many there are in all, across every page.
Example output
{
"count": 3,
"depth": "direct",
"found": true,
"has_more": true,
"ontology_id": "go",
"page": 1,
"relations": "is_a",
"summary": "19 children of apoptotic process (GO:0006915) in go, 3 listed",
"term": {
"id": "GO:0006915",
"iri": "http://purl.obolibrary.org/obo/GO_0006915",
"label": "apoptotic process",
"ontology_id": "go"
},
"terms": [
{
"definition": "Any apoptotic process in an inflammatory cell, any cell participating in the inflammatory response to a foreign substance e.g. neutrophil, macrophage.",
"has_children": true,
"id": "GO:0006925",
"iri": "http://purl.obolibrary.org/obo/GO_0006925",
"is_defining_ontology": true,
"is_obsolete": false,
"label": "inflammatory cell apoptotic process",
"synonyms": [
"apoptosis of inflammatory cells",
"inflammatory cell apoptosis",
"inflammatory cell programmed cell death by apoptosis"
]
},
{
"definition": "A form of programmed cell death induced by external or internal signals that trigger the activity of proteolytic caspases, whose actions dismantle a muscle cell and result in its death. A muscle cell is a mature contractile cell, commonly known as a myocyte, that forms one of three kinds of muscle.",
"has_children": true,
"id": "GO:0010657",
"iri": "http://purl.obolibrary.org/obo/GO_0010657",
"is_defining_ontology": true,
"is_obsolete": false,
"label": "muscle cell apoptotic process",
"synonyms": [
"muscle cell apoptosis"
]
},
{
"definition": "Any apoptotic process in a myeloid cell, a cell of the monocyte, granulocyte, mast cell, megakaryocyte, or erythroid lineage.",
"has_children": true,
"id": "GO:0033028",
"iri": "http://purl.obolibrary.org/obo/GO_0033028",
"is_defining_ontology": true,
"is_obsolete": false,
"label": "myeloid cell apoptotic process",
"synonyms": [
"apoptosis of myeloid cells",
"myeloid cell apoptosis"
]
}
],
"total": 19
}List a term's parents
List the broader terms above a term: its direct parents, or all its ancestors up to the root, by is a links or with part of too. Useful to roll annotations up to a broader category.
Inputs
- Term
termtextRequired - The term's id, such as GO:0006915 or HP:0001250, its IRI, or a link to its OLS page. 'Search terms' or 'Map text to a term' find one by name.
- Ontology
ontologytext - The ontology to read the term in. Leave empty for the ontology that defines it; pick another to see the term as that ontology imports it.
- How far
depthtext - Direct parents only, or every ancestor up to the root.One of:
direct(Direct parents only),all(All ancestors, up to the root). Default:direct. - Links to follow
relationstext - Subclass (is a) links only, or part of, develops from and the other links the ontology treats as hierarchical too.One of:
is_a(Subclass links only (is a)),hierarchical(Subclass and part of links (is a, part of, develops from)). Default:is_a. - Most rows
limitnumber - The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default:
100. - Page
pagenumber - Which page of results to return, from 1.From 1 to 100000. Default:
1.
Outputs
countnumber- How many are listed here.
depthtext- direct (one level) or all (every level).
foundtrue/false- True when OLS has the term. False when it doesn't, and the rest is empty.
has_moretrue/false- True when there are more on later pages.
ontology_idtext- The id of the ontology it is in, such as go.
pagenumber- Which page this is, from 1.
relationstext- is_a (subclass links) or hierarchical (part of and the like too).
summarytext- One line saying what was found.
termobject- The term the step was about, as OLS has it.
termslist- The terms, in OLS's order.
totalnumber- How many there are in all, across every page.
Example output
{
"count": 3,
"depth": "all",
"found": true,
"has_more": true,
"ontology_id": "go",
"page": 1,
"relations": "hierarchical",
"summary": "6 ancestors of apoptotic process (GO:0006915) in go, 3 listed",
"term": {
"id": "GO:0006915",
"iri": "http://purl.obolibrary.org/obo/GO_0006915",
"label": "apoptotic process",
"ontology_id": "go"
},
"terms": [
{
"definition": "An entity that has temporal parts and that happens, unfolds or develops through time.",
"has_children": true,
"id": "BFO:0000003",
"iri": "http://purl.obolibrary.org/obo/BFO_0000003",
"is_defining_ontology": false,
"is_obsolete": false,
"label": "occurrent",
"synonyms": []
},
{
"definition": "An occurrent that has temporal proper parts and for some time t, p s-depends_on some material entity at t.",
"has_children": true,
"id": "BFO:0000015",
"iri": "http://purl.obolibrary.org/obo/BFO_0000015",
"is_defining_ontology": false,
"is_obsolete": false,
"label": "process",
"synonyms": []
},
{
"definition": "A biological process is the execution of a genetically-encoded biological module or program. It consists of all the steps required to achieve the specific biological objective of the module. A biological process is accomplished by a particular set of molecular functions carried out by specific gene products (or macromolecular complexes), often in a highly regulated manner and in a particular temporal sequence.",
"has_children": true,
"id": "GO:0008150",
"iri": "http://purl.obolibrary.org/obo/GO_0008150",
"is_defining_ontology": true,
"is_obsolete": false,
"label": "biological_process",
"synonyms": [
"biological process",
"physiological process",
"single organism process"
]
}
],
"total": 6
}List a term's relationships
List a term's links to other terms beyond its place in the hierarchy: part of, has part, develops from, produces, regulates and the rest, with the term at the other end. Outgoing links say what the term relates to; incoming ones, what relates to it.
Inputs
- Term
termtextRequired - The term's id, such as GO:0006915 or HP:0001250, its IRI, or a link to its OLS page. 'Search terms' or 'Map text to a term' find one by name.
- Ontology
ontologytext - The ontology to read the term in. Leave empty for the ontology that defines it; pick another to see the term as that ontology imports it.
- Direction
directiontext - Which links to list.One of:
outgoing(What this term links to),incoming(What links to this term),both. Default:outgoing. - Include is a links
include_is_atrue/false - List the term's parents (and, incoming, its children) too. Turn off for the other relationships alone.Default:
true.
Outputs
countnumber- How many are listed here.
directiontext- outgoing, incoming or both.
foundtrue/false- True when OLS has the term. False when it doesn't, and the rest is empty.
ontology_idtext- The id of the ontology it is in, such as go.
relationslist- The kinds of link found, such as part of or develops from.
relationshipslist- Each link, outgoing first, then by relation.
summarytext- One line saying what was found.
termobject- The term the step was about, as OLS has it.
Example output
{
"count": 4,
"direction": "outgoing",
"found": true,
"ontology_id": "uberon",
"relations": [
"develops from",
"in taxon",
"is a",
"part of"
],
"relationships": [
{
"direction": "outgoing",
"id": "UBERON:0005172",
"iri": "http://purl.obolibrary.org/obo/UBERON_0005172",
"label": "abdomen element",
"relation": "is a",
"relation_iri": "http://www.w3.org/2000/01/rdf-schema#subClassOf"
},
{
"direction": "outgoing",
"id": "UBERON:0008836",
"iri": "http://purl.obolibrary.org/obo/UBERON_0008836",
"label": "liver bud",
"relation": "develops from",
"relation_iri": "http://purl.obolibrary.org/obo/RO_0002202"
},
{
"direction": "outgoing",
"id": "NCBITaxon:7742",
"iri": "http://purl.obolibrary.org/obo/NCBITaxon_7742",
"label": "Vertebrata <vertebrates>",
"relation": "in taxon",
"relation_iri": "http://purl.obolibrary.org/obo/RO_0002162"
},
{
"direction": "outgoing",
"id": "UBERON:0000949",
"iri": "http://purl.obolibrary.org/obo/UBERON_0000949",
"label": "endocrine system",
"relation": "part of",
"relation_iri": "http://purl.obolibrary.org/obo/BFO_0000050"
}
],
"summary": "4 links for liver (UBERON:0002107) (develops from, in taxon, is a, part of)",
"term": {
"id": "UBERON:0002107",
"iri": "http://purl.obolibrary.org/obo/UBERON_0002107",
"label": "liver",
"ontology_id": "uberon"
}
}List an ontology's terms
List every term of an ontology a page at a time, imported ones and obsolete ones included, each with its definition and synonyms: for copying a vocabulary into a spreadsheet or database.
Inputs
- Ontology
ontologytextRequired - The ontology: pick one, or type its id, such as go or mondo.
- Most rows
limitnumber - The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default:
100. - Page
pagenumber - Which page of results to return, from 1.From 1 to 100000. Default:
1.
Outputs
countnumber- How many are listed here.
has_moretrue/false- True when there are more on later pages.
ontology_idtext- The id of the ontology it is in, such as go.
pagenumber- Which page this is, from 1.
summarytext- One line saying what was found.
termslist- The terms on this page.
totalnumber- How many there are in all, across every page.
Example output
{
"count": 3,
"has_more": true,
"ontology_id": "so",
"page": 1,
"summary": "2,752 terms in so, 3 on page 1",
"terms": [
{
"definition": null,
"has_children": false,
"id": "BS:00003",
"iri": "http://purl.obolibrary.org/obo/BS_00003",
"is_defining_ontology": false,
"is_obsolete": true,
"label": "BS_00003",
"synonyms": []
},
{
"definition": null,
"has_children": false,
"id": "BS:0000338",
"iri": "http://purl.obolibrary.org/obo/BS_0000338",
"is_defining_ontology": false,
"is_obsolete": true,
"label": "BS_0000338",
"synonyms": []
},
{
"definition": null,
"has_children": false,
"id": "BS:0000339",
"iri": "http://purl.obolibrary.org/obo/BS_0000339",
"is_defining_ontology": false,
"is_obsolete": true,
"label": "BS_0000339",
"synonyms": []
}
],
"total": 2752
}List an ontology's top-level terms
List the terms at the top of an ontology, such as GO's molecular function, cellular component and biological process: the ones the ontology names as its roots, else its own terms without a parent, or every term without a parent.
Inputs
- Ontology
ontologytextRequired - The ontology: pick one, or type its id, such as go or mondo.
- Which roots
whichtext - The ontology's own top-level terms, or every term without a parent, which includes classes it imports on their own.One of:
top(The ontology's own top-level terms),all(Every term without a parent, imported ones included). Default:top. - Most rows
limitnumber - The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default:
100. - Page
pagenumber - Which page of results to return, from 1.From 1 to 100000. Default:
1.
Outputs
countnumber- How many are listed here.
has_moretrue/false- True when there are more on later pages.
ontology_idtext- The id of the ontology it is in, such as go.
pagenumber- Which page this is, from 1.
sourcetext- Where the list came from: preferred (the roots the ontology names), defined_here (its own terms without a parent) or all (every term without a parent, imported ones included).
summarytext- One line saying what was found.
termslist- The top-level terms.
totalnumber- How many there are in all, across every page.
Example output
{
"count": 3,
"has_more": false,
"ontology_id": "go",
"page": 1,
"source": "preferred",
"summary": "3 top-level terms in go",
"terms": [
{
"definition": "A molecular process that can be carried out by the action of a single macromolecular machine, usually via direct physical interactions with other molecular entities. Function in this sense denotes an action, or activity, that a gene product (or a complex) performs.",
"has_children": true,
"id": "GO:0003674",
"iri": "http://purl.obolibrary.org/obo/GO_0003674",
"is_defining_ontology": true,
"is_obsolete": false,
"label": "molecular_function",
"synonyms": [
"molecular function"
]
},
{
"definition": "A location, relative to cellular compartments and structures, occupied by a macromolecular machine. There are three types of cellular components described in the gene ontology: (1) the cellular anatomical entity where a gene product carries out a molecular function (e.g., plasma membrane, cytoskeleton) or membrane-enclosed compartments (e.g., mitochondrion); (2) virion components, where viral proteins act, and (3) the stable macromolecular complexes of which gene product are parts (e.g., the clathrin complex).",
"has_children": true,
"id": "GO:0005575",
"iri": "http://purl.obolibrary.org/obo/GO_0005575",
"is_defining_ontology": true,
"is_obsolete": false,
"label": "cellular_component",
"synonyms": [
"cell or subcellular entity",
"cellular component",
"subcellular entity"
]
},
{
"definition": "A biological process is the execution of a genetically-encoded biological module or program. It consists of all the steps required to achieve the specific biological objective of the module. A biological process is accomplished by a particular set of molecular functions carried out by specific gene products (or macromolecular complexes), often in a highly regulated manner and in a particular temporal sequence.",
"has_children": true,
"id": "GO:0008150",
"iri": "http://purl.obolibrary.org/obo/GO_0008150",
"is_defining_ontology": true,
"is_obsolete": false,
"label": "biological_process",
"synonyms": [
"biological process",
"physiological process",
"single organism process"
]
}
],
"total": 3
}List ontologies
List the ontologies OLS holds, or those matching a search: each one's id, title, version, number of terms, licence and when OLS last loaded it.
Inputs
- Search for
searchtext - Only list ontologies matching these words, such as disease or anatomy. Leave empty for all of them.
- Most rows
limitnumber - The most rows to return, up to 500. The result says how many there are in all.From 1 to 500. Default:
50. - Page
pagenumber - Which page of results to return, from 1.From 1 to 100000. Default:
1.
Outputs
countnumber- How many are listed here.
has_moretrue/false- True when there are more on later pages.
ontologieslist- The ontologies.
pagenumber- Which page this is, from 1.
searchtext- The text the ontologies were filtered by, if any.
summarytext- One line saying what was found.
totalnumber- How many there are in all, across every page.
Example output
{
"count": 3,
"has_more": true,
"ontologies": [
{
"description": "An ontology for describing the classification of human diseases organized by etiology.",
"domain": "health",
"homepage": "https://disease-ontology.org",
"id": "doid",
"last_loaded": "2026-10-25T00:08:25",
"licence": {
"name": "CC0 1.0",
"recorded": true,
"statement": null,
"url": "https://creativecommons.org/publicdomain/zero/1.0/"
},
"number_of_terms": 19724,
"prefix": "DOID",
"title": "Human Disease Ontology",
"url": "https://www.ebi.ac.uk/ols4/ontologies/doid",
"version": "2026-09-30"
},
{
"description": "An ontology to describe entities related to cardiovascular diseases",
"domain": "health",
"homepage": "https://github.com/OpenLHS/CVDO",
"id": "cvdo",
"last_loaded": "2026-10-25T00:08:15",
"licence": {
"name": "CC BY 4.0",
"recorded": true,
"statement": null,
"url": "https://creativecommons.org/licenses/by/4.0/"
},
"number_of_terms": 720,
"prefix": "CVDO",
"title": "Cardiovascular Disease Ontology",
"url": "https://www.ebi.ac.uk/ols4/ontologies/cvdo",
"version": "2024-05-17"
},
{
"description": "An ontology to describe and classify mental diseases such as schizophrenia, annotated with DSM-IV and ICD codes where applicable",
"domain": "health",
"homepage": "https://github.com/jannahastings/mental-functioning-ontology",
"id": "mfomd",
"last_loaded": "2026-10-25T00:09:59",
"licence": {
"name": "CC BY 3.0",
"recorded": true,
"statement": null,
"url": "http://creativecommons.org/licenses/by/3.0/"
},
"number_of_terms": 1172,
"prefix": "MFOMD",
"title": "Mental Disease Ontology",
"url": "https://www.ebi.ac.uk/ols4/ontologies/mfomd",
"version": "2020-04-26"
}
],
"page": 1,
"search": "disease",
"summary": "23 ontologies matching 'disease', 3 listed",
"total": 23
}Map text to a term
Find the term that best fits a piece of text, such as a disease typed into a form: a term with that label first, then one with it as a synonym, then OLS's closest match. Says which kind of match it is and lists the other candidates, so a workflow can accept an exact match and send the rest for review.
Inputs
- Text
texttextRequired - The text to map, such as heart attack.
- Ontologies
ontologiestext - Only look in this ontology: pick one, or type several ids separated by commas, such as mondo, hp. Leave empty for all of them; one or two well-chosen ones (mondo for diseases, hp for phenotypes) give the clearest results.
- Exact matches only
exact_onlytrue/false - Only accept a term whose label or a synonym is the text. Leave off to fall back to OLS's closest match.Default:
false. - Most candidates
limitnumber - The most candidates to return, up to 50.From 1 to 50. Default:
5.
Outputs
alternativeslist- Other candidates, best first, for a person to check.
foundtrue/false- True when a term was found.
match_typetext- How the term matches: label (its name is the text), synonym (one of its synonyms is), or closest (OLS's best guess). Empty when nothing matched.
summarytext- One line saying what was found.
termobject- The best term.
texttext- The text that was mapped.
Example output
{
"alternatives": [
{
"description": "Gross necrosis of the myocardium, as a result of interruption of the blood supply to the area, as in coronary thrombosis.",
"id": "MONDO:0005068",
"iri": "http://purl.obolibrary.org/obo/MONDO_0005068",
"is_defining_ontology": true,
"label": "myocardial infarction",
"ontology_id": "mondo",
"ontology_prefix": "MONDO",
"synonyms": [
"MI, myocardial infarction",
"infarction (MI), myocardial",
"myocardial infarction, (MI)"
],
"type": "class"
}
],
"found": true,
"match_type": "synonym",
"summary": "Myocardial infarction (HP:0001658) in hp has it as a synonym",
"term": {
"description": "Necrosis of the myocardium caused by an obstruction of the blood supply to the heart and often associated with chest pain, shortness of breath, palpitations, and anxiety as well as characteristic EKG findings and elevation of serum markers including creatine kinase-MB fraction and troponin.",
"id": "HP:0001658",
"iri": "http://purl.obolibrary.org/obo/HP_0001658",
"is_defining_ontology": true,
"label": "Myocardial infarction",
"ontology_id": "hp",
"ontology_prefix": "HP",
"synonyms": [
"Heart attack",
"MI"
],
"type": "class"
},
"text": "heart attack"
}Search terms
Search for terms by name, synonym, definition or id, across every ontology in OLS or only in some: each match's id, label, ontology, description and synonyms. Narrow it to exact matches, to obsolete terms, to the ontology that defines each term, or to the terms under one term.
Inputs
- Search for
querytextRequired - The words or id to search for.
- Ontologies
ontologiestext - Only look in this ontology: pick one, or type several ids separated by commas, such as mondo, hp. Leave empty for all of them; one or two well-chosen ones (mondo for diseases, hp for phenotypes) give the clearest results.
- Look for
entity_typetext - Terms (classes) are what most annotation uses. Properties are the relations between terms.One of:
class(Terms),property(Properties (relations such as part of)),individual(Individuals (named instances)),any(Any of these). Default:class. - Exact match
exacttrue/false - Only match the whole text, not words within it. With 'Search in' set to label and synonyms, only terms named exactly this.Default:
false. - Search in
fieldslist - Which parts of a term to search. Leave empty for all of them.One or more of:
label,synonym(Synonyms),description(Definition and description),identifier(Identifier, such as GO:0006915),iri,annotations(Other annotations). - Obsolete terms
obsoletetext - Leave out obsolete terms, or find only them (to check what replaced a retired term).One of:
exclude(Leave out obsolete terms),only(Only obsolete terms). Default:exclude. - Only where defined
defined_here_onlytrue/false - Skip copies of a term that other ontologies import, so each term is listed once, from the ontology that defines it.Default:
false. - Under term
under_termtext - Only find terms under this one, such as MONDO:0005015 (diabetes mellitus) for kinds of diabetes: its id or IRI.
- Links to follow
relationstext - With 'Under term': follow subclass (is a) links only, or part of and the other hierarchical links too.One of:
is_a(Subclass links only (is a)),hierarchical(Subclass and part of links (is a, part of, develops from)). Default:is_a. - Most rows
limitnumber - The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default:
25. - Page
pagenumber - Which page of results to return, from 1.From 1 to 100000. Default:
1.
Outputs
countnumber- How many are listed here.
has_moretrue/false- True when there are more on later pages.
pagenumber- Which page this is, from 1.
querytext- What was searched for.
summarytext- One line saying what was found.
termslist- The matches, best first.
totalnumber- How many matches there are in all.
Example output
{
"count": 3,
"has_more": true,
"page": 1,
"query": "diabetes",
"summary": "316 matches for 'diabetes' in mondo, hp, 3 listed",
"terms": [
{
"description": "Persons with type II diabetes mellitus rarely develop ketoacidosis.",
"id": "HP:0005978",
"iri": "http://purl.obolibrary.org/obo/HP_0005978",
"is_defining_ontology": true,
"label": "Type II diabetes mellitus",
"ontology_id": "hp",
"ontology_prefix": "HP",
"synonyms": [
"Diabetes mellitus Type II",
"Diabetes mellitus type 2",
"Diabetes mellitus, noninsulin-dependent"
],
"type": "class"
},
{
"description": "The onset of type 1 diabetes is typically during adolescence, but it can develop at any age.",
"id": "HP:0100651",
"iri": "http://purl.obolibrary.org/obo/HP_0100651",
"is_defining_ontology": true,
"label": "Type I diabetes mellitus",
"ontology_id": "hp",
"ontology_prefix": "HP",
"synonyms": [
"Diabetes mellitus Type I",
"Juvenile diabetes mellitus",
"Insulin-dependent diabetes mellitus"
],
"type": "class"
},
{
"description": "A type of diabetes mellitus related not to lack of insulin but rather to lack of response to insulin on the part of the target tissues of insulin such as muscle, fat, and liver cells. This type of diabetes is typically associated with increases both in blood glucose concentrations as well as in fasting and postprandial serum insulin levels.",
"id": "HP:0000831",
"iri": "http://purl.obolibrary.org/obo/HP_0000831",
"is_defining_ontology": true,
"label": "Insulin-resistant diabetes mellitus",
"ontology_id": "hp",
"ontology_prefix": "HP",
"synonyms": [
"Insulin resistant diabetes mellitus",
"Insulin resistant diabetes",
"Insulin-resistant diabetes"
],
"type": "class"
}
],
"total": 316
}Suggest labels
Complete what someone has started typing with term labels and synonyms, for autocomplete: 'diabetes mel' gives diabetes mellitus and its kin. Each suggestion is listed once.
Inputs
- Text
querytextRequired - The start of a label, such as diabetes mel.
- Ontologies
ontologiestext - Only look in this ontology: pick one, or type several ids separated by commas, such as mondo, hp. Leave empty for all of them; one or two well-chosen ones (mondo for diseases, hp for phenotypes) give the clearest results.
- Most suggestions
limitnumber - The most suggestions to return, up to 50.From 1 to 50. Default:
10.
Outputs
countnumber- How many are listed here.
querytext- The text completed.
suggestionslist- Labels and synonyms that complete the text, best first.
summarytext- One line saying what was found.
Example output
{
"count": 5,
"query": "diabetes mel",
"suggestions": [
"diabetes mellitus",
"DM - Diabetes mellitus",
"diabetes mellitus AE",
"diabetes mellitus, dog",
"FH: Diabetes mellitus"
],
"summary": "5 suggestions for 'diabetes mel'"
}