---
title: "IUCN Red List Category for a name usage"
method: GET
path: "/v1/species/{usageKey}/iucnRedListCategory"
tags: ["Species"]
---

# IUCN Red List Category for a name usage

`GET /v1/species/{usageKey}/iucnRedListCategory`

## Request

- Base URL: `https://api.gbif.org`
- URL: `https://api.gbif.org/v1/species/{usageKey}/iucnRedListCategory`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gbif/apis/species-api/docs/v1/species/:usageKey/iucnRedListCategory/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the IUCN Red List Category for a name usage.  If the matching IUCN usage does not contain a category, Not Evaluated (NE) is returned.

## Path parameters

- `usageKey` integer, required

## Response `200`

IUCN Red List category

- IucnRedListCategory
  - `category` 'EXTINCT' | 'EXTINCT_IN_THE_WILD' | 'REGIONALLY_EXTINCT' | 'CRITICALLY_ENDANGERED' | 'ENDANGERED' | 'VULNERABLE' | 'NEAR_THREATENED' | 'LEAST_CONCERN' | 'DATA_DEFICIENT' | 'NOT_APPLICABLE' | 'NOT_EVALUATED': The taxonomic threat status as given in our https://api.gbif.org/v1/enumeration/basic/ThreatStatus[ThreatStatus enum].
  - `usageKey` integer: The name usage “taxon“ key to which this Red List category applies.
  - `scientificName` string: The scientific name.
  - `taxonomicStatus` 'ACCEPTED' | 'DOUBTFUL' | 'SYNONYM' | 'HETEROTYPIC_SYNONYM' | 'HOMOTYPIC_SYNONYM' | 'PROPARTE_SYNONYM' | 'MISAPPLIED': The taxonomic status of the name.
  - `acceptedName` string: The accepted name, if the name is a synonym.
  - `acceptedUsageKey` integer: The accepted name's usage key, if the name is a synonym.
  - `iucnTaxonID` string: The original IUCN identifier used for the name usage.
  - `code` string: The code for the taxonomic threat status as given in our https://api.gbif.org/v1/enumeration/basic/ThreatStatus[ThreatStatus enum].

## Other responses

- `400`: Invalid query
- `404`: Name usage not found

## Changes

- **2026-08-20** `03ccf35f8dd9`: 1 warning
  - for the `path` request parameter `usageKey`, the min was set to `0.00`

[Operation history](https://skmtc.dev/gbif/apis/species-api/changes/v1/species/:usageKey/iucnRedListCategory/get.md)

---

[API](https://skmtc.dev/gbif/apis/species-api.md) - [All operations](https://skmtc.dev/gbif/apis/species-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gbif/apis/species-api/revisions/340d13cde148?raw)