---
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`

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

---

[API](https://skmtc.net/gbif/apis/species-api.md) · [All operations](https://skmtc.net/gbif/apis/species-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gbif/species-api/versions/156fd5bac927/schema)