What the species registers we hold say about one species, each status cited

US Endangered Species Act lists, Canada's Species at Risk Act and COSEWIC, provincial acts, the IUCN Red List, CITES, CMS, the EU Habitats and Birds Directives' annexes and UK schedules. Each row: the status as printed, an outcome (listed, listed_qualified = only under a population or subspecies to confirm, watch_listed, assessed_not_listed, scope_undetermined), and a cite block (instrument, edition, the line the register prints, source URL and sha256). Registers searched that do not name the species are in silent, with what each one's silence means.

get/designations

Request

  • Base URL: https://passage-data.com/api/v1
  • URL: https://passage-data.com/api/v1/designations
  • Auth: one of:
    • none
    • HTTP bearer
    • API key in header x-api-key

Query parameters

speciesstring required

A scientific name (Myotis lucifugus, Rana draytonii; authorship allowed) or a common name exactly as a register prints it (little brown myotis).

placestring

ISO 3166 code of where the species is: US, CA, GB, FR, US-CA, CA-ON, GB-SCT. Only the registers that reach it are searched, with the global ones (IUCN, CITES, and CMS where the country is a Party).

Response

Rows, or a refused block (designations.none_held with registers_searched, species.unreadable, species.ambiguous with candidates)

queryobject
nameobject
searchedobject
totalinteger
silentobject[]
refusedobject

Changes

No recorded changes to this operation across all 1 revision of this API.