IUCN
IUCN Red List of Threatened Species
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
IUCN Red List of Threatened Species
Endpoints 50
Assessment
- GETRetrieves an assessment
/api/v4/assessment/:assessment_idReturns assessment data for a supplied <code>assessment_id</code>. This endpoint returns the same assessment data that you would see on an assessment page on…
Biogeographical Realms
- GETReturns a list of biogeographic realm codes
/api/v4/biogeographical_realms/List available biogeographical realms (e.g. Neotropical or Palearctic) - GETReturns a collection of assessments for a biogeographical realm code
/api/v4/biogeographical_realms/:codeReturns a list of the latest assessments for a given biogeographical realm. Results are paginated (100 assessments per page).
Comprehensive Groups
- GETReturns a list of comprehensive groups
/api/v4/comprehensive_groups/List the available comprehensive groups. - GETReturns a collection of assessments for a comprehensive group name
/api/v4/comprehensive_groups/:nameReturns a list of the latest assessments for an comprehensive group name. Results are paginated (100 assessments per page).
Conservation Actions
- GETreturns a list of conservation actions
/api/v4/conservation_actions/ - GETreturns a collection of assessments for a conservation action code
/api/v4/conservation_actions/:code
Countries
- GETReturns a list of countries by ISO alpha-2 code
/api/v4/countries/Return a list of countries - GETReturns a collection of assessments for a given country ISO alpha-2 code
/api/v4/countries/:codeReturn the latest assessments for a given country code. Results are paginated (100 assessments per page)
FAOs
- GETReturns a list of FAOs
/api/v4/faos/List the available FAOs. - GETReturns a collection of assessments for an FAO code
/api/v4/faos/:codeReturns a list of the latest assessments for an FAO code. Results are paginated (100 assessments per page).
Growth Forms
- GETReturns a list of growth forms
/api/v4/growth_forms/List the available growth forms. - GETReturns a collection of assessments for a given growth form code
/api/v4/growth_forms/:codeReturns a list of the latest assessments for a given growth form code. Results are paginated (100 assessments per page)
Green Status
- GETReturns a list of all Green Status assessments
/api/v4/green_status/allList all Green Status assessments.
Habitats
- GETReturns a list of habitat codes.
/api/v4/habitats/List the available habitat codes as per the Habitats Classification Scheme (v3.1) - GETReturns a collection of assessments for a given habitat code
/api/v4/habitats/:codeReturn the latest assessments for a given habitat code (e.g. Forest - Temperate or Marine Intertidal). These habitat codes correspond to the IUCN Red List…
Information
- GETReturns the current version number of the IUCN Red List of Threatened Species API
/api/v4/information/api_version - GETReturns the current IUCN Red List of Threatened Species version
/api/v4/information/red_list_version
Population Trends
- GETReturns a list of population trends
/api/v4/population_trends/ - GETReturns a collection of assessments for a given population trend code
/api/v4/population_trends/:codeReturn a list of the latest assessments based on a population trend (i.e. increasing, decreasing, stable or unknown)
Red List Categories
- GETReturns a list of Red List categories
/api/v4/red_list_categories/Returns a list of Red List categories. This endpoint returns categories for the current IUCN Red List Categories and Criteria (v3.1) as well as older versions… - GETReturns a collection of assessments for a given Red List category code
/api/v4/red_list_categories/:codeReturns a list of the latest assessments for a given Red List category code. Note that a code may not be unique across Categories and Criteria versions.…
Research
- GETReturns a list of habitat codes.
/api/v4/research/List the available research codes as per the Research Needed Classification Scheme (v1.0) - GETReturns a collection of assessments for a given research code
/api/v4/research/:codeReturn the latest assessments for a given research code. These research codes correspond to the IUCN Red List Research Needed Classification Scheme (v1.0)
Scopes
- GETreturns a list of scopes
/api/v4/scopes/Returns a list of assessment scopes - GETReturns a collection of assessments for a given scope code
/api/v4/scopes/:codeReturns a list of the latest assessments for a given geographic scope. Results are paginated (100 assessments per page)
Statistics
- GETReturn count of the number of species with assessments
/api/v4/statistics/countReturns a count of the number of species which have assessments.
Stresses
- GETReturns a list of stressors
/api/v4/stresses/Returns a list of stressors - GETreturns a collection of assessments for a given stress code
/api/v4/stresses/:codeReturns a list of the latest assessments for a given stressor. Results are paginated (100 assessments per page)
Systems
- GETReturns a list of systems
/api/v4/systems/Returns a list of systems - GETReturns a collection of assessments for a given system code
/api/v4/systems/:codeReturns a list of the latest assessments for a given system Results are paginated (100 assessments per page)
Taxa
- GETReturns a collection of assessments for a given SIS id
/api/v4/taxa/sis/:sis_idReturns summary latest and historic assessment data for a given <code>SIS id</code>. This endpoint does not provide all assessment data that can be found from… - GETReturns a collection of assessments for a given genus_name and species_name (i.e. Latin binomial) and optional infra_name (i.e. Latin trinomial)
/api/v4/taxa/scientific_name?genus_name=string&species_name=stringReturns summary latest and historic assessment data for a given <code>genus_name</code> and <code>species_name</code> and optional <code>infra_name</code>.… - GETReturns a list of all kingdom names
/api/v4/taxa/kingdom/Returns a collection of all kingdom names - GETReturns a collection of the latests assessments for a given kingdom_name
/api/v4/taxa/kingdom/:kingdom_nameReturns the latest assessments for the supplied kingdom. Results are paginated (100 assessments per page) - GETReturns a list of all phylum names
/api/v4/taxa/phylum/Returns a collection of all phylum names - GETReturns a collection of the latests assessments for a given phylum_name
/api/v4/taxa/phylum/:phylum_nameReturns the latest assessments for the supplied phylum. Results are paginated (100 assessments per page) - GETReturns a list of all class names
/api/v4/taxa/class/Returns a collection of all class names - GETReturns a collection of the latests assessments for a given class_name
/api/v4/taxa/class/:class_nameReturns the latest assessments for the supplied class. Results are paginated (100 assessments per page) - GETReturns a list of all order names
/api/v4/taxa/order/Returns a collection of the all order names - GETReturns a collection of the latests assessments for a given order_name
/api/v4/taxa/order/:order_nameReturns the latest assessments for the supplied order. Results are paginated (100 assessments per page) - GETReturns a list of all family names
/api/v4/taxa/family/Returns a collection of the all family names - GETReturns a collection of the latests assessments for a given family_name
/api/v4/taxa/family/:family_nameReturns the latest assessments for the supplied family. Results are paginated (100 assessments per page) - GETReturns a collection of the all latest global assessments for taxa that are possibly extinct
/api/v4/taxa/possibly_extinctReturns a collection of all latest global assessments for taxa that are possibly extinct - GETReturns a collection of the all latest global assessments for taxa that are possibly extinct in the wild
/api/v4/taxa/possibly_extinct_in_the_wildReturns a collection of all latest global assessments for taxa that are possibly extinct in the wild
Threats
- GETReturns a list of threats
/api/v4/threats/Returns a list of threat codes. - GETReturns a collection of assessments for a given threat code
/api/v4/threats/:codeReturns the latest assessments for a given threat code. This will only return assessments for the threat code specified. You will need to do additional…
Use and Trade
- GETReturns a list of use and trades
/api/v4/use_and_trade/Returns a list of use and trade codes. - GETReturns a collection of assessments for a given use and trade code
/api/v4/use_and_trade/:codeReturns the latest assessments for a given use and trade code.
AssessmentSearch
- GETSearches for assessments
/api/v4/assessment_search?filter_on[]=eu_27_post_2020_endemicReturns a paginated list of latest assessment IDs matching the filter_on criteria. Allowed values are: eu_27_post_2020_endemic, amazing, cr_pe, cr_pew,…
API details
- Authentication
- An API key in the Authorization header
- Operations
- 50 operations on 50 pathsGET 50
- Main resources
- Taxa 14Biogeographical Realms 2Comprehensive Groups 2Conservation Actions 2Countries 2FAOs 2Growth Forms 2Habitats 2Information 2Population Trends 2
- Response formats
application/json- Description format
- OpenAPI 3.0.1, API version
v4 - Links
- OpenAPI document
- Listed from
- Iucnredlist's published OpenAPI description
How to test the IUCN in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the IUCN collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Retrieves an assessment” (GET /api/v4/assessment/:assessment_id), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the IUCN?
IUCN Red List of Threatened Species It is listed under Data & analytics and has 50 endpoints.
Who publishes the IUCN?
It is listed from Iucnredlist's public API description (an OpenAPI document), not published by Iucnredlist on Swastik Codes. Anyone who controls iucnredlist.org can claim the profile by adding a DNS TXT record.
How do I authenticate with the IUCN?
With an API key in the Authorization header.
How many endpoints does the IUCN have?
50 operations on 50 paths (50 GET). The largest groups are Taxa, Biogeographical Realms, Comprehensive Groups, Conservation Actions.
Is forking the IUCN free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.