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

ActionWhat it does
Get a termLook 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 rootGet every chain of is a links from the top of the ontology down to a term, as text (entity > disease > ...
Get an ontologyGet 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 childrenList 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 parentsList 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 relationshipsList 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 termsList 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 termsList 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 ontologiesList 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 termFind 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 termsSearch 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 labelsComplete 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

TermtermtextRequired
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.
Ontologyontologytext
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

TermtermtextRequired
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.
Ontologyontologytext
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

OntologyontologytextRequired
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

TermtermtextRequired
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.
Ontologyontologytext
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 fardepthtext
Direct children only, or every descendant at every level.One of: direct (Direct children only), all (All descendants). Default: direct.
Links to followrelationstext
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 rowslimitnumber
The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default: 100.
Pagepagenumber
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

TermtermtextRequired
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.
Ontologyontologytext
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 fardepthtext
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 followrelationstext
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 rowslimitnumber
The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default: 100.
Pagepagenumber
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

TermtermtextRequired
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.
Ontologyontologytext
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.
Directiondirectiontext
Which links to list.One of: outgoing (What this term links to), incoming (What links to this term), both. Default: outgoing.
Include is a linksinclude_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

OntologyontologytextRequired
The ontology: pick one, or type its id, such as go or mondo.
Most rowslimitnumber
The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default: 100.
Pagepagenumber
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

OntologyontologytextRequired
The ontology: pick one, or type its id, such as go or mondo.
Which rootswhichtext
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 rowslimitnumber
The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default: 100.
Pagepagenumber
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 forsearchtext
Only list ontologies matching these words, such as disease or anatomy. Leave empty for all of them.
Most rowslimitnumber
The most rows to return, up to 500. The result says how many there are in all.From 1 to 500. Default: 50.
Pagepagenumber
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

TexttexttextRequired
The text to map, such as heart attack.
Ontologiesontologiestext
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 onlyexact_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 candidateslimitnumber
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 forquerytextRequired
The words or id to search for.
Ontologiesontologiestext
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 forentity_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 matchexacttrue/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 infieldslist
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 termsobsoletetext
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 defineddefined_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 termunder_termtext
Only find terms under this one, such as MONDO:0005015 (diabetes mellitus) for kinds of diabetes: its id or IRI.
Links to followrelationstext
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 rowslimitnumber
The most rows to return, up to 1,000. The result says how many there are in all.From 1 to 1000. Default: 25.
Pagepagenumber
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

TextquerytextRequired
The start of a label, such as diabetes mel.
Ontologiesontologiestext
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 suggestionslimitnumber
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'"
}

On this page