Authoritative source for species-level extinction-risk assessments. doriiOS uses it for the canonical category, assessment year, criteria string, population trend, and threat narrative text.
Access
- API v3:
https://apiv3.iucnredlist.org/api/v3/ — requires a free
API token (env: IUCN_TOKEN).
- Endpoints used:
species/<name> — core assessment metadatathreats/species/name/<name> — structured threat listnarrative/species/<name> — long-form sections (rationale, habitat,
threats, conservation actions)
Notes
- Rate-limited; the ETL batches per-species calls and caches results to
data/raw/iucn/<aphia>.json so re-runs are no-ops.
- A species' OBIS
category field can lag the canonical IUCN assessment by
months — we always prefer the IUCN Red List value when both are present.