Service metadata + category breakdown

Frammenti di codice

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

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

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

Risposta di esempio

Una risposta reale di questo endpoint, acquisita dall'ultimo health check.

{
    "data": {
        "service": "redlist-api",
        "endpoints": {
            "GET /v1/meta": "This document, with the category breakdown.",
            "GET /v1/class": "Species in a taxonomic class (class=, e.g. MAMMALIA, AVES).",
            "GET /v1/search": "Search by scientific or common name (q=, min 2 chars).",
            "GET /v1/species": "Species by scientific name (name=, e.g. Panthera leo) or taxon id (id=).",
            "GET /v1/category": "Species in a Red List category (category=, e.g. CR, EN, VU)."
        },
        "categories": {
            "CR": 9553,
            "DD": 21134,
            "EN": 17784,
            "EW": 54,
            "EX": 482,
            "LC": 84829,
            "NT": 8652,
            "VU": 16208,
            "LR/CD": 93,
            "LR/LC": 176,
            "LR/NT": 335
        },
        "description": "IUCN Red List conservation status for 150,000+ assessed species: scientific name, common name, taxonomy (kingdom/class/family), Red List category (CR/EN/VU/NT/LC/DD/EW/EX) and IUCN taxon id. Look up by scientific name, search, or list by category or taxonomic class. Distinct from worms-api (marine taxonomy). No key.",
        "total_species": 159300,
        "classes_indexed": 67
    },
    "meta": {
        "timestamp": "2026-06-08T18:25:05.487Z",
        "request_id": "82b5f634-708e-4ddd-a401-99221a24dd7a"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}