Usage notes

Codefragmenten

curl "https://api.oanor.com/biosamples-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/biosamples-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/biosamples-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/biosamples-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Voorbeeldrespons

Een echte respons van dit endpoint, vastgelegd bij de laatste health check.

{
    "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
}