{"openapi":"3.1.0","info":{"title":"OLS Ontology API","version":"1.0.0","description":"The EMBL-EBI Ontology Lookup Service (OLS) as an API — a single access point to more than 280 biomedical and scientific ontologies and controlled vocabularies in one place: the Gene Ontology (GO), the Human Disease Ontology (DOID), the Human Phenotype Ontology (HP), ChEBI (chemical entities), Uberon (anatomy), the Experimental Factor Ontology (EFO), Mondo, NCIt and many more. /v1/search?q=diabetes searches terms across all ontologies (or restrict to one with ontology=doid), returning each match's label, OBO id (such as DOID:9351 or GO:0008150), ontology, IRI and a short definition. /v1/term?ontology=doid&id=DOID:9351 returns a single term's detail — its label, definition, IRI, synonyms and whether it is obsolete. /v1/ontologies browses the available ontologies with their id, title, description and number of terms. OBO ids look like DOID:9351, GO:0008150, HP:0000118 or CHEBI:15377. Ideal for biomedical natural-language processing, data annotation and harmonisation, autocomplete over scientific terminology, and semantic and knowledge-graph tooling. Data from EMBL-EBI OLS (open). This is a general ontology / controlled-vocabulary lookup spanning many domains — broader than a single medical thesaurus such as MeSH.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ols-api","description":"oanor gateway"}],"tags":[{"name":"Ontology"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/ontologies":{"get":{"operationId":"get_v1_ontologies","tags":["Ontology"],"summary":"Browse available ontologies","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max results (1-300)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"total":280,"ontologies":[{"id":"addicto","terms":1363,"title":"Addiction Ontology","description":"The Addiction Ontology (AddictO) is an ontology being developed all aspects of addiction research."},{"id":"ado","terms":1963,"title":"Alzheimer's Disease Ontology (ADO)","description":"Alzheimer's Disease Ontology is a knowledge-based ontology that encompasses varieties of concepts related to Alzheimer'S Disease, foundamentally structured by upper level Basic Formal Ontology(BFO). This Ontology is enriched by the interrelational entities that demonstrate the nextwork of the unders"},{"id":"aeo","terms":430,"title":"Anatomical Entity Ontology","description":"AEO is an ontology of anatomical structures that expands CARO, the Common Anatomy Reference Ontology"},{"id":"afo","terms":3516,"title":"Allotrope Merged Ontology Suite","description":"Allotrope Merged Ontology Suite"},{"id":"afpo","terms":473,"title":"African Population Ontology","description":"AfPO is an ontology that can be used in the study of diverse populations across Africa. It brings together publicly available demographic, anthropological and genetic data relating to African people in a standardised and structured format. The AfPO can be employed to classify African study participa"},{"id":"agro","terms":4162,"title":"Agronomy Ontology","description":"AgrO is an ontlogy for representing agronomic practices, techniques, variables and related entities"},{"id":"aism","terms":8614,"title":"Ontology for the Anatomy of the Insect SkeletoMuscular system","description":"The ontology for the Anatomy of the Insect SkeletoMuscular system (AISM) contains terms used to describe the cuticle - as a single anatomical structure - and the skeletal muscle system, to be used in insect biodiversity research."},{"id":"amphx","terms":403,"title":"Amphioxus Development and Anatomy Ontology (AMPHX)","description":"An ontology for the development and anatomy of Amphioxus (Branchiostoma lanceolatum)."},{"id":"apo","terms":619,"title":"Ascomycete Phenotype Ontology (APO)","description":"A structured controlled vocabulary for the phenotypes of Ascomycete fungi."},{"id":"apollo_sv","terms":1716,"title":"Apollo Structured Vocabulary","description":"An OWL2 ontology of phenomena in infectious disease epidemiology and population biology for use in epidemic simulation."},{"id":"aro","terms":8582,"title":"Antibiotic Resistance Ontology","description":"Antibiotic resistance genes and mutations"},{"id":"bao","terms":8936,"title":"BioAssay Ontology","description":"The BioAssay Ontology (BAO) describes biological screening assays and their results including high-throughput screening (HTS) data for the purpose of categorizing assays and data analysis. BAO is an extensible, knowledge-based, highly expressive (currently SHOIQ(D)) description of biological assays "},{"id":"bcgo","terms":2270,"title":"Beta Cell Genomics Ontology","description":"An application ontology built for beta cell genomics studies."},{"id":"bcio","terms":2545,"title":"The Behaviour Change Intervention Ontology","description":"The Behaviour Change Intervention Ontology is an ontology for all aspects of human behaviour change interventions and their evaluation."},{"id":"bco","terms":253,"title":"Biological Collections Ontology","description":"An ontology to support the interoperability of biodiversity data, including data on museum collections, environmental/metagenomic samples, and ecological surveys."},{"id":"bfo","terms":35,"title":"Basic Formal Ontology","description":"The upper level ontology upon which OBO Foundry ontologies are built."},{"id":"biolink","terms":663},{"id":"bmont","terms":640,"title":"Biomarker Ontology (BMONT)","description":"An application ontology that represents comprehensive knowledge involving a variety of fields of medical and biological aspects."},{"id":"bspo","terms":169,"title":"Biological Spatial Ontology","description":"An ontology for respresenting spatial concepts, anatomical axes, gradients, regions, planes, sides and surfaces. These concepts can be used at multiple biological scales and in a diversity of taxa, including plants, animals and fungi. The BSPO is used to provide a source of anatomical location descr"},{"id":"bto","terms":6569,"title":"The BRENDA Tissue Ontology (BTO)","description":"A structured controlled vocabulary for the source of an enzyme comprising tissues, cell lines, cell types and cell cultures."},{"id":"cao","terms":445,"title":"Chemical Analysis Metadata Platform (ChAMP) Ontology version 0.2","description":"The Chemical Analysis Ontology (CAO) is an ontology developed as part of the Chemical Analaysis Metadata Project (ChAMP) as a resource to semantically annotate standards developed using the ChAMP platform.  For more information go to http://champ-project.org."},{"id":"caro","terms":720,"title":"Common Anatomy Reference Ontology","description":"The Common Anatomy Reference Ontology (CARO) is being developed to facilitate interoperability between existing anatomy ontologies for different species, and will provide a template for building new anatomy ontologies."},{"id":"ccf","terms":41,"title":"Human Reference Atlas Common Coordinate Framework Ontology","description":"The Common Coordinate Framework (CCF) Ontology is an application ontology built to support the development of the Human Reference Atlas (HRA).  It unifies vocabulary for HRA construction and usage—making it possible to ingest external data sources; supporting uniform tissue sample registration that "},{"id":"cco","terms":277685,"title":"Cell Cycle Ontology","description":"The Cell Cycle Ontology extends existing ontologies for cell cycle knowledge building a resource that integrates and manages knowledge about the cell cycle components and regulatory aspects."},{"id":"cdao","terms":164,"title":"Comparative Data Analysis Ontology","description":"a formalization of concepts and relations relevant to evolutionary comparative analysis"},{"id":"cdno","terms":2109,"title":"Compositional Dietary Nutrition Ontology","description":"The CDNO provides structured terminologies to describe nutritional attributes of material entities that contribute to human diet. These terms are intended primarily to be associated with datasets that quantify concentration of chemical nutritional components derived from samples taken from any stage"},{"id":"ceph","terms":1574,"title":"Cephalopod Ontology","description":"An anatomical and developmental ontology for cephalopods"},{"id":"chebi","terms":224691,"title":"Chemical Entities of Biological Interest","description":"A structured classification of molecular entities of biological interest focusing on 'small' chemical compounds."},{"id":"cheminf","terms":2141,"title":"chemical information ontology (cheminf) - information entities about chemical entities","description":"Includes terms for the descriptors commonly used in cheminformatics software applications and the algorithms which generate them."},{"id":"chiro","terms":13279,"title":"CHEBI Integrated Role Ontology","description":"CHEBI provides a distinct role hierarchy. Chemicals in the structural hierarchy are connected via a 'has role' relation. CHIRO provides links from these roles to useful other classes in other ontologies. This will allow direct connection between chemical structures (small molecules, drugs) and what "},{"id":"chmo","terms":3234,"title":"Chemical Methods Ontology","description":"CHMO, the chemical methods ontology, describes methods used to"},{"id":"cido","terms":31924,"title":"CIDO: Ontology of Coronavirus Infectious Disease","description":"The Ontology of Coronavirus Infectious Disease (CIDO) is a community-driven open-source biomedical ontology in the area of coronavirus infectious disease. The CIDO is developed to provide standardized human- and computer-interpretable annotation and representation of various coronavirus infectious d"},{"id":"cio","terms":44,"title":"Confidence Information Ontology","description":"An ontology to capture confidence information about annotations."},{"id":"cl","terms":19151,"title":"Cell Ontology","description":"An ontology of cell types."},{"id":"clao","terms":1516,"title":"Collembola Anatomy Ontology","description":"CLAO is an ontology of anatomical terms employed in morphological descriptions for the Class Collembola (Arthropoda: Hexapoda)."},{"id":"clo","terms":43327,"title":"CLO: Cell Line Ontology","description":"The Cell Line Ontology (CLO) is a community-based ontology of cell lines. The CLO is developed to unify publicly available cell line entry data from multiple sources to a standardized logically defined format based on consensus design patterns."},{"id":"clyh","terms":265,"title":"Clytia hemisphaerica Development and Anatomy Ontology (CLYH)","description":"Anatomy, development and life cycle stages - planula, polyp, medusa/jellyfish - of the cnidarian hydrozoan species, Clytia hemiphaerica."},{"id":"cmo","terms":4144,"title":"Clinical measurement ontology","description":"Morphological and physiological measurement records generated from clinical and model organism research and health programs."},{"id":"cmpo","terms":1058,"title":"Cellular Microscopy Phenotype Ontology","description":"CMPO is a species neutral ontology for describing general phenotypic observations relating to the whole cell, cellular components, cellular processes and cell populations."},{"id":"cob","terms":69,"title":"Core Ontology for Biology and Biomedicine","description":"COB brings together key terms from a wide range of OBO projects to improve interoperability."},{"id":"colao","terms":894,"title":"Coleoptera Anatomy Ontology","description":"The Coleoptera Anatomy Ontology contains terms used for describing the anatomy and phenotype of beetles in biodiversity research."},{"id":"covoc","terms":563,"title":"CoVoc Coronavirus Vocabulary","description":"The COVID-19 Vocabulary (COVoc) is an ontology containing terms related to the research of the COVID-19 pandemic. This includes host organisms, pathogenicity, gene and gene products, barrier gestures, treatments and more."},{"id":"cpont","terms":9119,"title":"Critical Path Ontology","description":"An application ontology for integrating data from the Critical Path Institute's Rare Disease Cures Accelerator Data and Analytica Platform (RDCA-DAP)."},{"id":"credit","terms":16,"title":"Contributor Roles Taxonomy","description":"CRediT (Contributor Roles Taxonomy) is high-level taxonomy, including 14 roles, that can be used to represent the roles typically played by contributors to scientific scholarly output. The roles describe each contributor’s specific contribution to the scholarly output."},{"id":"cro","terms":145,"title":"Contributor Role Ontology","description":"A classification of the diverse roles performed in the work leading to a published research output in the sciences. Its purpose to provide transparency in contributions to scholarly published work, to enable improved systems of attribution, credit, and accountability."},{"id":"cteno","terms":709,"title":"Ctenophore Ontology","description":"An anatomical and developmental ontology for ctenophores (Comb Jellies)"},{"id":"cvdo","terms":720,"title":"Cardiovascular Disease Ontology","description":"An ontology to describe entities related to cardiovascular diseases"},{"id":"dc","terms":0},{"id":"dcat","terms":77},{"id":"dcterms","terms":22}]},"meta":{"timestamp":"2026-06-01T16:23:32.694Z","request_id":"11e67441-1833-441f-897c-c39f4d673f9e"},"status":"ok","message":"Ontologies retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Ontology"],"summary":"Search terms across ontologies","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search text, e.g. diabetes","schema":{"type":"string"},"example":"diabetes"},{"name":"ontology","in":"query","required":false,"description":"Restrict to one ontology, e.g. doid","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"diabetes","terms":[{"iri":"http://purl.obolibrary.org/obo/DOID_9351","label":"diabetes mellitus","obo_id":"DOID:9351","ontology":"doid","description":"A glucose metabolism disease that is characterized by chronic hyperglycaemia with disturbances of carbohydrate, fat and protein metabolism resulting from defects in insulin secretion, insulin action, or both."},{"iri":"http://purl.obolibrary.org/obo/NCIT_C2985","label":"Diabetes Mellitus","obo_id":"NCIT:C2985","ontology":"ncit","description":"A metabolic disorder characterized by abnormally high blood sugar levels due to diminished production of insulin or insulin resistance/desensitization."},{"iri":"http://purl.obolibrary.org/obo/NCIT_C212592","label":"Diabetes Service Type","obo_id":"NCIT:C212592","ontology":"ncit","description":"The service type that is associated with the Health Level 7 Fast Healthcare Interoperability Resources Diabetes code."},{"iri":"http://purl.obolibrary.org/obo/MONDO_0005015","label":"diabetes mellitus","obo_id":"MONDO:0005015","ontology":"mondo","description":"A metabolic disorder characterized by abnormally high blood sugar levels due to diminished production of insulin or insulin resistance/desensitization."},{"iri":"http://purl.obolibrary.org/obo/DOID_9351","label":"diabetes mellitus","obo_id":"DOID:9351","ontology":"bmont","description":"A glucose metabolism disease that is characterized by chronic hyperglycaemia with disturbances of carbohydrate, fat and protein metabolism resulting from defects in insulin secretion, insulin action, or both."},{"iri":"http://purl.obolibrary.org/obo/DOID_9351","label":"diabetes mellitus","obo_id":"DOID:9351","ontology":"exmo","description":"A glucose metabolism disease that is characterized by chronic hyperglycaemia with disturbances of carbohydrate, fat and protein metabolism resulting from defects in insulin secretion, insulin action, or both."},{"iri":"http://purl.obolibrary.org/obo/DOID_9351","label":"diabetes mellitus","obo_id":"DOID:9351","ontology":"vo","description":"A glucose metabolism disease that is characterized by chronic hyperglycaemia with disturbances of carbohydrate, fat and protein metabolism resulting from defects in insulin secretion, insulin action, or both."},{"iri":"http://purl.obolibrary.org/obo/DOID_11714","label":"gestational diabetes","obo_id":"DOID:11714","ontology":"doid","description":"A diabetes mellitus that manifests during pregnancy."},{"iri":"http://purl.obolibrary.org/obo/DOID_9409","label":"diabetes insipidus","obo_id":"DOID:9409","ontology":"doid","description":"A kidney disease that is characterized by polydipsia and polyuria with a dilute urine having a specific gravity less than 1.010, hypernatremia, and dehydration."},{"iri":"http://purl.obolibrary.org/obo/HP_0000819","label":"Diabetes mellitus","obo_id":"HP:0000819","ontology":"hp","description":"A group of abnormalities characterized by hyperglycemia and glucose intolerance."},{"iri":"http://purl.obolibrary.org/obo/HP_0000873","label":"Diabetes insipidus","obo_id":"HP:0000873","ontology":"hp","description":"A state of excessive water intake and hypotonic (dilute) polyuria. Diabetes insipidus may be due to failure of vasopressin (AVP) release (central or neurogenic diabetes insipidus) or to a failure of the kidney to respond to AVP (nephrogenic diabetes insipidus)."},{"iri":"http://snomed.info/id/127012008","label":"Lipoatrophic diabetes","obo_id":"SNOMED:127012008","ontology":"snomed"},{"iri":"http://snomed.info/id/309417009","label":"Diabetes dietitian","obo_id":"SNOMED:309417009","ontology":"snomed"},{"iri":"http://snomed.info/id/315051004","label":"Diabetes resolved","obo_id":"SNOMED:315051004","ontology":"snomed"},{"iri":"http://snomed.info/id/399144008","label":"Bronze diabetes","obo_id":"SNOMED:399144008","ontology":"snomed"},{"iri":"http://snomed.info/id/702706001","label":"Diabetes clinic","obo_id":"SNOMED:702706001","ontology":"snomed"},{"iri":"http://snomed.info/id/73211009","label":"Diabetes mellitus","obo_id":"SNOMED:73211009","ontology":"snomed"},{"iri":"http://purl.obolibrary.org/obo/HP_0009800","label":"Maternal diabetes","obo_id":"HP:0009800","ontology":"hp","description":"Maternal diabetes can either be a gestational, mostly type 2 diabetes, or a type 1 diabetes. Essential is the resulting maternal hyperglycemia as a non-specific teratogen, imposing the same risk of congenital malformations to pregnant women with both type 1 and type2 diabetes."},{"iri":"http://snomed.info/id/170774007","label":"Diabetes: practice program (finding)","obo_id":"SNOMED:170774007","ontology":"snomed"},{"iri":"http://purl.obolibrary.org/obo/DOID_0081055","label":"central diabetes insipidus","obo_id":"DOID:0081055","ontology":"doid","description":"A diabetes insipidus that is characterized by polyuria and polydipsia due to a deficiency in vasopressin synthesis."}],"total":16055,"ontology":"all"},"meta":{"timestamp":"2026-06-01T16:23:33.167Z","request_id":"9a9eafa4-e109-4db1-9e08-aa5845188290"},"status":"ok","message":"Search results retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/term":{"get":{"operationId":"get_v1_term","tags":["Ontology"],"summary":"A term detail","description":"","parameters":[{"name":"ontology","in":"query","required":true,"description":"Ontology id, e.g. doid","schema":{"type":"string"},"example":"doid"},{"name":"id","in":"query","required":true,"description":"OBO id, e.g. DOID:9351","schema":{"type":"string"},"example":"DOID:9351"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"term":{"iri":"http://purl.obolibrary.org/obo/DOID_9351","url":"https://www.ebi.ac.uk/ols4/ontologies/doid/classes/http%253A%252F%252Fpurl.obolibrary.org%252Fobo%252FDOID_9351","label":"diabetes mellitus","obo_id":"DOID:9351","ontology":"doid","synonyms":["diabetes"],"description":"A glucose metabolism disease that is characterized by chronic hyperglycaemia with disturbances of carbohydrate, fat and protein metabolism resulting from defects in insulin secretion, insulin action, or both.","is_obsolete":false}},"meta":{"timestamp":"2026-06-01T16:23:33.417Z","request_id":"27d24b6d-1d56-45f5-9cd2-9ddaee78a08d"},"status":"ok","message":"Term retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"OLS (EMBL-EBI Ontology Lookup Service) is a single access point to 280+ biomedical and scientific ontologies — the Gene Ontology (GO), Human Disease Ontology (DOID), Human Phenotype Ontology (HP), ChEBI (chemicals), Uberon (anatomy), EFO, Mondo, NCIT and many more. /v1/search?q=diabetes = search terms across all ontologies (or restrict with ontology=doid), returning each match's label, OBO id (e.g. DOID:9351), ontology, IRI and a short definition; /v1/term?ontology=doid&id=DOID:9351 = a single term's detail — label, definition, IRI, synonyms and obsolete flag; /v1/ontologies = browse the available ontologies with their id, title, description and term count. OBO ids look like DOID:9351, GO:0008150, HP:0000118, CHEBI:15377. Data from EMBL-EBI OLS (open). A general ontology/controlled-vocabulary lookup across many domains — broader than a single medical thesaurus (e.g. MeSH). Ideal for biomedical NLP, data annotation and harmonisation, and semantic tooling.","source":"EMBL-EBI Ontology Lookup Service (OLS4) — ebi.ac.uk/ols4","endpoints":["/v1/search","/v1/term","/v1/ontologies","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:33.501Z","request_id":"c2904bba-e4ec-4190-ad7f-4ea1b5e52675"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":52000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2150,"monthly_call_quota":222000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5900,"monthly_call_quota":800000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ols-api"}