Usage notes

Extraits de code

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

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

$ch = curl_init("https://api.oanor.com/ensembl-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/ensembl-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "note": "The Ensembl genome database. /v1/gene?species=human&symbol=BRCA2 (add expand=1 for transcripts) = a gene's stable id, biotype, location & description; /v1/lookup?id=ENSG00000139618 = any feature by Ensembl stable id (gene/transcript/exon); /v1/xrefs?species=human&symbol=BRCA2 = external database cross-references; /v1/variant?species=human&id=rs699 = a sequence variant (alleles, consequence, minor-allele frequency, clinical significance, genomic mappings); /v1/region?species=human&region=17:43044295-43125483&feature=gene = features overlapping a genomic region (max 1 Mb; feature=gene|transcript|exon|variation|repeat|cds); /v1/sequence?id=ENSP00000369497&type=protein = the genomic|cds|cdna|protein sequence; /v1/assembly?species=human = genome-assembly metadata (assembly name, accession, karyotype, chromosomes). Species accept common names (human, mouse) or binomials (homo_sapiens). 300+ vertebrate species. Data courtesy of Ensembl / EMBL-EBI.",
        "source": "Ensembl REST API (rest.ensembl.org)",
        "endpoints": [
            "/v1/gene",
            "/v1/lookup",
            "/v1/xrefs",
            "/v1/variant",
            "/v1/region",
            "/v1/sequence",
            "/v1/assembly",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T08:14:25.482Z",
        "request_id": "abae661b-5220-48ca-b3d1-70d483bbfd1f"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}