Usage notes

Code snippets

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

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

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

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "WoRMS is the authoritative, expert-curated taxonomic register of the world's marine species. /v1/search?name=Orcinus orca = search species by scientific name (fuzzy=true for partial matching, marine_only=true to restrict), returning each match's AphiaID, accepted name, authority, rank, taxonomic status, valid name and higher classification; /v1/species?id=137102 = a species' full record by AphiaID — name, authority, status, the kingdom-to-genus classification, marine/brackish flags and citation; /v1/classification?id=137102 = the complete taxonomic tree from Biota down to the taxon, rank by rank; /v1/vernaculars?id=137102 = the common (vernacular) names with their language codes. AphiaID is WoRMS' stable identifier (get it from /v1/search). Data from WoRMS (CC BY). This is authoritative marine taxonomy & nomenclature — distinct from species-occurrence/biodiversity databases (GBIF) and from sequence/genome databases. Ideal for marine biology, fisheries, ecology and biodiversity-data harmonisation.",
        "source": "WoRMS — World Register of Marine Species (marinespecies.org)",
        "endpoints": [
            "/v1/search",
            "/v1/species",
            "/v1/classification",
            "/v1/vernaculars",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:23.880Z",
        "request_id": "76614337-0c7d-4e0f-8b4b-a7f53d2b5406"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}