{"openapi":"3.1.0","info":{"title":"BioSamples API","version":"1.0.0","description":"BioSamples as an API, powered by EMBL-EBI — the database that stores and links the metadata of biological samples, the physical specimens behind biological experiments. A sample in BioSamples carries a stable accession (such as SAMEA3231268) and a rich set of characteristics — organism, tissue or organism part, cell type, sex, disease, developmental stage, strain and any submitter-provided attributes — and is referenced by other EBI archives including the European Nucleotide Archive (ENA), ArrayExpress and PRIDE. /v1/search?q=liver searches samples by free text and returns each match's accession, name, organism and release date. /v1/sample?id=SAMEA3231268 returns a sample's metadata — its accession, name, NCBI taxon id, organism, release and update dates, the number of relationships to other samples, and its characteristics flattened to a clean key→value map. Accessions look like SAMEA…, SAMN… or SAMD…; get one from the search endpoint. Ideal for life-science data integration, sample tracking, metadata harmonisation and linking sequencing or expression data back to its source specimen. Data from EMBL-EBI BioSamples (public). This is a biological-sample metadata registry — distinct from study (BioStudies), sequence (ENA), variant (ClinVar) and structure databases.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/biosamples-api","description":"oanor gateway"}],"tags":[{"name":"Samples"},{"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/sample":{"get":{"operationId":"get_v1_sample","tags":["Samples"],"summary":"A sample metadata","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"BioSamples accession (from /v1/search), e.g. SAMEA3231268","schema":{"type":"string"},"example":"SAMEA3231268"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMEA3231268","name":"SPN_E_2_TB_E_1-sc-2216731","domain":"Webin-2","tax_id":1427524,"update":"2024-02-06","release":"2015-06-30","organism":"mixed sample","accession":"SAMEA3231268","relationships":0,"characteristics":{"strain":"mixed sample","organism":"mixed sample","External Id":"SAMEA3231268","INSDC status":"public","Submitter Id":"SPN_E_2_TB_E_1-sc-2216731","ENA-CHECKLIST":"ERC000011","SRA accession":"ERS652502","ENA-LAST-UPDATE":"2018-03-09T12:37:01Z","scientific_name":"mixed sample","ENA-FIRST-PUBLIC":"2015-06-30T09:40:43Z","INSDC center name":"SC","INSDC last update":"2018-03-09T12:37:01Z","INSDC first public":"2015-06-30T09:40:43Z","ArrayExpress-Species":"mixed sample","ArrayExpress-StrainOrLine":"mixed sample"}}},"meta":{"timestamp":"2026-06-01T16:23:15.347Z","request_id":"b4a4479e-32fb-43cb-9205-dfa81d13f1d6"},"status":"ok","message":"Sample 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":["Samples"],"summary":"Search biological samples","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search text, e.g. liver","schema":{"type":"string"},"example":"liver"},{"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":"liver","samples":[{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004696","name":"SAMD00004696","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00004696"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004746","name":"SAMD00004746","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00004746"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004760","name":"SAMD00004760","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00004760"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004776","name":"SAMD00004776","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00004776"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004811","name":"SAMD00004811","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00004811"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004813","name":"SAMD00004813","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00004813"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004821","name":"SAMD00004821","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00004821"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004864","name":"SAMD00004864","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00004864"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004877","name":"SAMD00004877","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00004877"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004955","name":"SAMD00004955","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00004955"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004979","name":"SAMD00004979","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00004979"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004984","name":"SAMD00004984","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00004984"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00004997","name":"SAMD00004997","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00004997"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00005006","name":"SAMD00005006","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00005006"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00005008","name":"SAMD00005008","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00005008"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00005020","name":"SAMD00005020","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00005020"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00005065","name":"SAMD00005065","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00005065"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00005169","name":"SAMD00005169","release":"2014-03-28","organism":"Homo sapiens","accession":"SAMD00005169"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00005227","name":"SAMD00005227","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00005227"},{"url":"https://www.ebi.ac.uk/biosamples/samples/SAMD00005264","name":"SAMD00005264","release":"2014-03-28","organism":"Mus musculus","accession":"SAMD00005264"}]},"meta":{"timestamp":"2026-06-01T16:23:16.125Z","request_id":"01162684-f918-4a8f-9798-523eaac2ad30"},"status":"ok","message":"Samples 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":"BioSamples is EMBL-EBI's registry of metadata about biological samples (specimens) — the physical material behind experiments, referenced by archives such as ENA, ArrayExpress and PRIDE. /v1/search?q=liver = search samples by free text, returning each sample's accession (e.g. SAMEA3231268), name, organism and release date; /v1/sample?id=SAMEA3231268 = a sample's metadata — accession, name, NCBI taxon id, organism, release and update dates, number of relationships, and its characteristics (organism, organism part/tissue, cell type, sex, disease, strain and any submitter-provided attributes, flattened to key→value). Accessions look like SAMEA…, SAMN… or SAMD…; get one from /v1/search. Data from EMBL-EBI BioSamples (public). This is a biological-sample metadata registry — distinct from study (BioStudies), sequence (ENA), variant and structure databases.","source":"EMBL-EBI BioSamples (ebi.ac.uk/biosamples)","endpoints":["/v1/search","/v1/sample","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:16.206Z","request_id":"2c861ff9-d9ef-4646-8fdc-069d9c89773b"},"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":2050,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":46000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1850,"monthly_call_quota":211000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5100,"monthly_call_quota":772000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/biosamples-api"}