| Title: | 'IUCN' Red List Client |
|---|---|
| Description: | 'IUCN' Red List (<https://api.iucnredlist.org/>) client. The 'IUCN' Red List is a global list of threatened and endangered species. Functions cover all of the Red List 'API' routes. An 'API' key is required. |
| Authors: | William Gearty [aut, cre], Scott Chamberlain [aut], rOpenSci [fnd] (https://ropensci.org/), Maëlle Salmon [ctb] |
| Maintainer: | William Gearty <[email protected]> |
| License: | MIT + file LICENSE |
| Version: | 0.7.1.9000 |
| Built: | 2024-10-04 17:14:16 UTC |
| Source: | https://github.com/ropensci/rredlist |
Return the latest assessments with a given conservation action needed (e.g., Land/water management or Species recovery). These conservation action codes correspond to the IUCN Red List Conservation Actions Classification Scheme (v2.0).
rl_actions( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_actions_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_actions( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_actions_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the conservation action to look up. If not supplied, a list of all conservation actions will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by conservation actions or research needed:
rl_research()
## Not run: # Get list of all conservation actions rl_actions() # Get assessments with Species recovery conservation action needed rl_actions("3_2") ## End(Not run)## Not run: # Get list of all conservation actions rl_actions() # Get assessments with Species recovery conservation action needed rl_actions("3_2") ## End(Not run)
Returns the current version number of the IUCN Red List of Threatened Species API
rl_api_version(key = NULL, ...)rl_api_version(key = NULL, ...)
key |
(character) An IUCN API token. See |
... |
Curl options passed to |
API version as character string
Red List information and statistics:
rl_citation(),
rl_sp_count(),
rl_version()
## Not run: rl_api_version() ## End(Not run)## Not run: rl_api_version() ## End(Not run)
Get the full details for a single IUCN Red List assessment
rl_assessment(id, key = NULL, parse = TRUE, ...) rl_assessment_(id, key = NULL, ...)rl_assessment(id, key = NULL, parse = TRUE, ...) rl_assessment_(id, key = NULL, ...)
id |
(integer) The unique identifier of the assessment. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
... |
Curl options passed to the GET request via
|
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
## Not run: # Get assessment details for Fratercula arctica ex1 <- rl_assessment(id = 166290968) ex1$red_list_category$code ex1$systems ## End(Not run)## Not run: # Get assessment details for Fratercula arctica ex1 <- rl_assessment(id = 166290968) ex1$red_list_category$code ex1$systems ## End(Not run)
Return a list of the latest assessments for a given category (e.g., Not Evaluated, Data Deficient, Least Concern, Near Threatened, Vulnerable, Endangered, Critically Endangered, Extinct in the Wild and Extinct). This endpoint returns categories for the current IUCN Red List Categories and Criteria (v3.1) as well as older versions (i.e., v2.3). Note that a code may not be unique across Categories and Criteria versions. Therefore, codes like "EX" will return assessments for EX v3.1 and EX v2.3.
rl_categories( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_categories_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )rl_categories( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_categories_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )
code |
(character) The code of the Red List category to look up. If not supplied, a list of all categories will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by threat details:
rl_pop_trends(),
rl_stresses(),
rl_threats(),
rl_use_and_trade()
## Not run: # Get all Red List categories rl_categories() # Get assessments for the Vulnerable category rl_categories("VU") ## End(Not run)## Not run: # Get all Red List categories rl_categories() # Get assessments for the Vulnerable category rl_categories("VU") ## End(Not run)
Full acknowledgement and citation needs to be given for using the API. Use this function to get the full citation for the current version of the Red List API. More details are available here: https://api.iucnredlist.org/.
rl_citation(key = NULL, ...)rl_citation(key = NULL, ...)
key |
(character) An IUCN API token. See |
... |
Curl options passed to |
Red List citation as character string
Red List information and statistics:
rl_api_version(),
rl_sp_count(),
rl_version()
## Not run: rl_citation() ## End(Not run)## Not run: rl_citation() ## End(Not run)
Get an assessment summary for a particular class
rl_class( class = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_class_(class = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_class( class = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_class_(class = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
class |
(character) The name of the class to look up. If not supplied, a list of all class names will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_family(),
rl_kingdom(),
rl_order(),
rl_phylum(),
rl_sis(),
rl_sis_latest(),
rl_species(),
rl_species_latest()
## Not run: # Get assessment summary for class ex1 <- rl_class(class = "Mammalia") nrow(ex1$assessments) ## End(Not run)## Not run: # Get assessment summary for class ex1 <- rl_class(class = "Mammalia") nrow(ex1$assessments) ## End(Not run)
Returns a list of the latest assessments for an comprehensive group name
rl_comp_groups( name = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_comp_groups_( name = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )rl_comp_groups( name = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_comp_groups_( name = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )
name |
(character) The code of the comprehensive group to look up. If not supplied, a list of all comprehensive groups will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments for specific sets of taxa
rl_extinct(),
rl_extinct_wild(),
rl_green(),
rl_growth_forms()
## Not run: # Get list of all comprehensive groups rl_comp_groups() # Get assessment summary for sea snakes rl_comp_groups('seasnakes') ## End(Not run)## Not run: # Get list of all comprehensive groups rl_comp_groups() # Get assessment summary for sea snakes rl_comp_groups('seasnakes') ## End(Not run)
Returns a collection of assessments for a given country code
rl_countries( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_countries_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )rl_countries( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_countries_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )
code |
(character) The ISO alpha-2 code of the country to look up. If not supplied, a list of all countries will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by geographic regions:
rl_faos(),
rl_realms(),
rl_scopes()
## Not run: # Get list of all countries rl_countries() # Get assessments for Madagascar rl_countries("MG") ## End(Not run)## Not run: # Get list of all countries rl_countries() # Get assessments for Madagascar rl_countries("MG") ## End(Not run)
Get an assessment summary for all possibly extinct taxa
rl_extinct(key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ...) rl_extinct_(key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_extinct(key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ...) rl_extinct_(key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Curl options passed to the GET request via
|
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments for specific sets of taxa
rl_comp_groups(),
rl_extinct_wild(),
rl_green(),
rl_growth_forms()
## Not run: ex1 <- rl_extinct() nrow(ex1$assessments) ## End(Not run)## Not run: ex1 <- rl_extinct() nrow(ex1$assessments) ## End(Not run)
Get an assessment summary for all taxa that are possibly extinct in the wild
rl_extinct_wild( key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_extinct_wild_(key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_extinct_wild( key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_extinct_wild_(key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Curl options passed to the GET request via
|
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments for specific sets of taxa
rl_comp_groups(),
rl_extinct(),
rl_green(),
rl_growth_forms()
## Not run: ex1 <- rl_extinct_wild() nrow(ex1$assessments) ## End(Not run)## Not run: ex1 <- rl_extinct_wild() nrow(ex1$assessments) ## End(Not run)
Get an assessment summary for a particular family
rl_family( family = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_family_(family = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_family( family = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_family_(family = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
family |
(character) The name of the family to look up. If not supplied, a list of all family names will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_class(),
rl_kingdom(),
rl_order(),
rl_phylum(),
rl_sis(),
rl_sis_latest(),
rl_species(),
rl_species_latest()
## Not run: # Get assessment summary for family ex1 <- rl_family(family = "Hominidae") nrow(ex1$assessments) ## End(Not run)## Not run: # Get assessment summary for family ex1 <- rl_family(family = "Hominidae") nrow(ex1$assessments) ## End(Not run)
Return assessments for a given marine fishing region as defined by the Food and Agriculture Organization (FAO) of the United Nations (e.g., Pacific - northwest, Arctic Sea). More details are available here: https://www.fao.org/fishery/en/area.
rl_faos( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_faos_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_faos( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_faos_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the FAO region to look up. If not supplied, a list of all FAO regions will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by geographic regions:
rl_countries(),
rl_realms(),
rl_scopes()
## Not run: # Get a list of all scopes rl_faos() # Get assessment summary for the Arctic Sea FAO region rl_faos(code = "18") ## End(Not run)## Not run: # Get a list of all scopes rl_faos() # Get assessment summary for the Arctic Sea FAO region rl_faos(code = "18") ## End(Not run)
List all Green Status assessments.
rl_green(key = NULL, parse = TRUE, ...) rl_green_(key = NULL, ...)rl_green(key = NULL, parse = TRUE, ...) rl_green_(key = NULL, ...)
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
... |
Curl options passed to the GET request via
|
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments for specific sets of taxa
rl_comp_groups(),
rl_extinct(),
rl_extinct_wild(),
rl_growth_forms()
## Not run: # Get list of Green Status assessments rl_green() ## End(Not run)## Not run: # Get list of Green Status assessments rl_green() ## End(Not run)
Returns a list of the latest assessments for a given growth form code.
rl_growth_forms( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_growth_forms_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )rl_growth_forms( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_growth_forms_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )
code |
(character) The code of the growth form to look up. If not supplied, a list of all growth forms will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments for specific sets of taxa
rl_comp_groups(),
rl_extinct(),
rl_extinct_wild(),
rl_green()
## Not run: # Get list of all growth forms rl_growth_forms() # Get assessment summary for lichens rl_growth_forms("LC") ## End(Not run)## Not run: # Get list of all growth forms rl_growth_forms() # Get assessment summary for lichens rl_growth_forms("LC") ## End(Not run)
Return the latest assessments for a given habitat (e.g., Forest - Temperate or Marine Intertidal). These habitat codes correspond to the IUCN Red List Habitats Classification Scheme (v3.1).
rl_habitats( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_habitats_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_habitats( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_habitats_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the habitat to look up. If not supplied, a list of all habitats will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by habitats and systems:
rl_systems()
## Not run: # Get list of all habitats rl_habitats() # Get assessments for Marine Intertidal habitat rl_habitats("12") ## End(Not run)## Not run: # Get list of all habitats rl_habitats() # Get assessments for Marine Intertidal habitat rl_habitats("12") ## End(Not run)
Get an assessment summary for a particular kingdom
rl_kingdom( kingdom = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_kingdom_( kingdom = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )rl_kingdom( kingdom = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_kingdom_( kingdom = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )
kingdom |
(character) The name of the kingdom to look up. If not supplied, a list of all kingdom names will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_class(),
rl_family(),
rl_order(),
rl_phylum(),
rl_sis(),
rl_sis_latest(),
rl_species(),
rl_species_latest()
## Not run: # Get assessment summary for kingdom ex1 <- rl_kingdom(kingdom = "Fungi") nrow(ex1$assessments) ## End(Not run)## Not run: # Get assessment summary for kingdom ex1 <- rl_kingdom(kingdom = "Fungi") nrow(ex1$assessments) ## End(Not run)
Get an assessment summary for a particular order
rl_order( order = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_order_(order = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_order( order = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_order_(order = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
order |
(character) The name of the order to look up. If not supplied, a list of all order names will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_class(),
rl_family(),
rl_kingdom(),
rl_phylum(),
rl_sis(),
rl_sis_latest(),
rl_species(),
rl_species_latest()
## Not run: # Get assessment summary for order ex1 <- rl_order(order = "Apiales") nrow(ex1$assessments) ## End(Not run)## Not run: # Get assessment summary for order ex1 <- rl_order(order = "Apiales") nrow(ex1$assessments) ## End(Not run)
Get an assessment summary for a particular phylum
rl_phylum( phylum = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_phylum_(phylum = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_phylum( phylum = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_phylum_(phylum = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
phylum |
(character) The name of the phylum to look up. If not supplied, a list of all phylum names will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_class(),
rl_family(),
rl_kingdom(),
rl_order(),
rl_sis(),
rl_sis_latest(),
rl_species(),
rl_species_latest()
## Not run: # Get assessment summary for phylum ex1 <- rl_phylum(phylum = "Annelida`") nrow(ex1$assessments) ## End(Not run)## Not run: # Get assessment summary for phylum ex1 <- rl_phylum(phylum = "Annelida`") nrow(ex1$assessments) ## End(Not run)
Return a list of the latest assessments based on a population trend (i.e. increasing, decreasing, stable or unknown).
rl_pop_trends( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_pop_trends_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )rl_pop_trends( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_pop_trends_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )
code |
(character) The code of the growth form to look up. If not supplied, a list of all growth forms will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by threat details:
rl_categories(),
rl_stresses(),
rl_threats(),
rl_use_and_trade()
## Not run: # Get list of all population trends rl_pop_trends() # Get assessment summary for stable population trends rl_pop_trends("2") ## End(Not run)## Not run: # Get list of all population trends rl_pop_trends() # Get assessment summary for stable population trends rl_pop_trends("2") ## End(Not run)
Get an assessment summary for a particular biogeographical realm (e.g., Neotropical or Palearctic)
rl_realms( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_realms_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_realms( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_realms_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the biogeographical realm to look up. If not supplied, a list of all biogeographical realms will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by geographic regions:
rl_countries(),
rl_faos(),
rl_scopes()
## Not run: # Get a list of all biogeographical realms rl_realms() # Get assessment summary for the Afrotropical biogeographical realm rl_realms(code = "0") ## End(Not run)## Not run: # Get a list of all biogeographical realms rl_realms() # Get assessment summary for the Afrotropical biogeographical realm rl_realms(code = "0") ## End(Not run)
Return the latest assessments with a given research needed (e.g., Taxonomy or Population trends). These research codes correspond to the IUCN Red List Research Needed Classification Scheme (v1.0).
rl_research( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_research_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_research( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_research_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the research type to look up. If not supplied, a list of all research types will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by conservation actions or research needed:
rl_actions()
## Not run: # Get list of all research types rl_research() # Get assessments with Taxonomy research needed rl_research("1_1") ## End(Not run)## Not run: # Get list of all research types rl_research() # Get assessments with Taxonomy research needed rl_research("1_1") ## End(Not run)
Return assessments for a given geographical assessment scope (e.g., Global,
Mediterranean). This is similar to the region argument of the old Red List
API and old versions of rredlist.
rl_scopes( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_scopes_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_scopes( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_scopes_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the scope to look up. If not supplied, a list of all scopes will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by geographic regions:
rl_countries(),
rl_faos(),
rl_realms()
## Not run: # Get a list of all scopes rl_scopes() # Get assessment summary for the Gulf of Mexico scope rl_scopes(code = "45433062") ## End(Not run)## Not run: # Get a list of all scopes rl_scopes() # Get assessment summary for the Gulf of Mexico scope rl_scopes(code = "45433062") ## End(Not run)
Get an assessment summary for a particular taxonomic entity based on its ID number from the IUCN Species Information Service (SIS).
rl_sis(id, key = NULL, parse = TRUE, ...) rl_sis_(id, key = NULL, ...)rl_sis(id, key = NULL, parse = TRUE, ...) rl_sis_(id, key = NULL, ...)
id |
(integer) The SIS ID of the taxonomic entity to look up. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
... |
Curl options passed to the GET request via
|
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_class(),
rl_family(),
rl_kingdom(),
rl_order(),
rl_phylum(),
rl_sis_latest(),
rl_species(),
rl_species_latest()
## Not run: # Get assessment summary for species ex1 <- rl_sis(id = 9404) nrow(ex1$assessments) ## End(Not run)## Not run: # Get assessment summary for species ex1 <- rl_sis(id = 9404) nrow(ex1$assessments) ## End(Not run)
Get the latest assessment for a particular taxonomic entity based on its ID
number from the IUCN Species Information Service (SIS). Wraps rl_sis() and
rl_assessment().
rl_sis_latest(id, key = NULL, parse = TRUE, ...)rl_sis_latest(id, key = NULL, parse = TRUE, ...)
id |
(integer) The SIS ID of the taxonomic entity to look up. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
... |
Curl options passed to the GET request via
|
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_class(),
rl_family(),
rl_kingdom(),
rl_order(),
rl_phylum(),
rl_sis(),
rl_species(),
rl_species_latest()
## Not run: # Get latest assessment for species ex1 <- rl_sis_latest(id = 9404) ex1$stresses ## End(Not run)## Not run: # Get latest assessment for species ex1 <- rl_sis_latest(id = 9404) ex1$stresses ## End(Not run)
Returns a count of the number of unique species which have assessments
rl_sp_count(key = NULL, ...) rl_sp_count_(key = NULL, ...)rl_sp_count(key = NULL, ...) rl_sp_count_(key = NULL, ...)
key |
(character) An IUCN API token. See |
... |
Curl options passed to |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Red List information and statistics:
rl_api_version(),
rl_citation(),
rl_version()
## Not run: # Get count of species with assessments rl_sp_count() ## End(Not run)## Not run: # Get count of species with assessments rl_sp_count() ## End(Not run)
Get an assessment summary for a particular species (i.e., Latin binomial) or subspecies/variety/subpopulation (i.e., Latin trinomial).
rl_species( genus, species, infra = NULL, subpopulation = NULL, key = NULL, parse = TRUE, ... ) rl_species_( genus, species, infra = NULL, subpopulation = NULL, key = NULL, ... )rl_species( genus, species, infra = NULL, subpopulation = NULL, key = NULL, parse = TRUE, ... ) rl_species_( genus, species, infra = NULL, subpopulation = NULL, key = NULL, ... )
genus |
(character) The genus name of the species to look up. |
species |
(character) The species epithet of the species to look up. |
infra |
(character) An optional name of the subspecies or variety to look up. |
subpopulation |
(character) An optional name of the geographically separate subpopulation to look up. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
... |
Curl options passed to the GET request via
|
Geographically separate subpopulations of a species are defined as those populations that are so isolated from others of the same species that it is considered extremely unlikely that there is any genetic interchange. In general, listings of such subpopulations are restricted to those that have been isolated for a long period of time.
Assessments of subspecies, varieties, and geographically separate subpopulations must adhere to the same standards as for species assessments. However, these assessments are only included provided there is a global assessment of the species as a whole.
Infraspecific ranks such as formas, subvarieties, cultivars, etc are not included in the Red List.
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_class(),
rl_family(),
rl_kingdom(),
rl_order(),
rl_phylum(),
rl_sis(),
rl_sis_latest(),
rl_species_latest()
## Not run: # Get assessment summary for species ex1 <- rl_species(genus = "Fratercula", species = "arctica") nrow(ex1$assessments) # Get assessment summary for subspecies ex2 <- rl_species(genus = "Gorilla", species = "gorilla", infra = "gorilla") nrow(ex2$assessments) ## End(Not run)## Not run: # Get assessment summary for species ex1 <- rl_species(genus = "Fratercula", species = "arctica") nrow(ex1$assessments) # Get assessment summary for subspecies ex2 <- rl_species(genus = "Gorilla", species = "gorilla", infra = "gorilla") nrow(ex2$assessments) ## End(Not run)
Get the latest assessment for a particular species (i.e., Latin binomial) or
subspecies/variety/subpopulation (i.e., Latin trinomial). Wraps
rl_species() and rl_assessment().
rl_species_latest( genus, species, infra = NULL, subpopulation = NULL, key = NULL, parse = TRUE, ... )rl_species_latest( genus, species, infra = NULL, subpopulation = NULL, key = NULL, parse = TRUE, ... )
genus |
(character) The genus name of the species to look up. |
species |
(character) The species epithet of the species to look up. |
infra |
(character) An optional name of the subspecies or variety to look up. |
subpopulation |
(character) An optional name of the geographically separate subpopulation to look up. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
... |
Curl options passed to the GET request via
|
Geographically separate subpopulations of a species are defined as those populations that are so isolated from others of the same species that it is considered extremely unlikely that there is any genetic interchange. In general, listings of such subpopulations are restricted to those that have been isolated for a long period of time.
Assessments of subspecies, varieties, and geographically separate subpopulations must adhere to the same standards as for species assessments. However, these assessments are only included provided there is a global assessment of the species as a whole.
Infraspecific ranks such as formas, subvarieties, cultivars, etc are not included in the Red List.
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by taxa:
rl_class(),
rl_family(),
rl_kingdom(),
rl_order(),
rl_phylum(),
rl_sis(),
rl_sis_latest(),
rl_species()
## Not run: # Get latest assessment for species ex1 <- rl_species_latest(genus = "Fratercula", species = "arctica") ex1$stresses # Get latest assessment for subspecies ex2 <- rl_species_latest(genus = "Gorilla", species = "gorilla", infra = "gorilla") ex2$stresses ## End(Not run)## Not run: # Get latest assessment for species ex1 <- rl_species_latest(genus = "Fratercula", species = "arctica") ex1$stresses # Get latest assessment for subspecies ex2 <- rl_species_latest(genus = "Gorilla", species = "gorilla", infra = "gorilla") ex2$stresses ## End(Not run)
Return a list of the latest assessments based on the stresses species are subject to (e.g., Ecosystem degradation, species disturbance, etc.).
rl_stresses( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_stresses_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_stresses( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_stresses_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the stress to look up. If not supplied, a list of all stresses will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by threat details:
rl_categories(),
rl_pop_trends(),
rl_threats(),
rl_use_and_trade()
## Not run: # Get all stresses rl_stresses() # Get assessment summary for ecosystem degradation stress rl_stresses("1_2") ## End(Not run)## Not run: # Get all stresses rl_stresses() # Get assessment summary for ecosystem degradation stress rl_stresses("1_2") ## End(Not run)
Return the latest assessments for a given system (e.g., terrestrial, freshwater or marine).
rl_systems( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_systems_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_systems( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_systems_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the system to look up. If not supplied, a list of all systems will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by habitats and systems:
rl_habitats()
## Not run: # Get list of all systems rl_systems() # Get assessment summary for marine system rl_systems("2") ## End(Not run)## Not run: # Get list of all systems rl_systems() # Get assessment summary for marine system rl_systems("2") ## End(Not run)
Return a list of the latest assessments which are subject to a specific threat (e.g., energy production and mining, climate change, and severe weather). This will only return assessments for the threat code specified. You will need to do additional requests for sub-threats (e.g., a request for threat code 2_1 will need additional requests for codes 2_1_1, 2_1_2, etc.).
rl_threats( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_threats_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)rl_threats( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_threats_(code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ...)
code |
(character) The code of the threat to look up. If not supplied, a list of all threats will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by threat details:
rl_categories(),
rl_pop_trends(),
rl_stresses(),
rl_use_and_trade()
## Not run: # Get all threats rl_threats() # Get assessment summary for intentional hunting and trapping rl_threats("5_1_1") ## End(Not run)## Not run: # Get all threats rl_threats() # Get assessment summary for intentional hunting and trapping rl_threats("5_1_1") ## End(Not run)
Return a list of the latest assessments which are subject to a specific use and trade.
rl_use_and_trade( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_use_and_trade_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )rl_use_and_trade( code = NULL, key = NULL, parse = TRUE, all = TRUE, page = 1, quiet = FALSE, ... ) rl_use_and_trade_( code = NULL, key = NULL, all = TRUE, page = 1, quiet = FALSE, ... )
code |
(character) The code of the use and trade to look up. If not supplied, a list of all uses and trades will be returned. |
key |
(character) An IUCN API token. See |
parse |
(logical) Whether to parse the output to list ( |
all |
(logical) Whether to retrieve all results at once or not. If
|
page |
(integer/numeric) Page to get if |
quiet |
(logical) Whether to suppress progress for multi-page downloads
or not. Default: |
... |
Includes the following filters that are supported by the API endpoint (refer to the API docs for more information):
Also supports any curl options passed to the GET
request via |
A list unless using a function with a trailing underscore, in which case json as character string is returned.
API docs at https://api.iucnredlist.org/.
Assessments by threat details:
rl_categories(),
rl_pop_trends(),
rl_stresses(),
rl_threats()
## Not run: # Get all stresses rl_use_and_trade() # Get assessment summary for medicinal use and trade rl_use_and_trade("3") ## End(Not run)## Not run: # Get all stresses rl_use_and_trade() # Get assessment summary for medicinal use and trade rl_use_and_trade("3") ## End(Not run)
Browse IUCN Red List API key request URL and provides instruction on how to store the key.
rl_use_iucn()rl_use_iucn()
Note that after filling the online form, you should receive an API key shortly but not immediately.
Invisibly returns the sign-up URL for the IUCN Red List API.
## Not run: # Sign up for an API key rl_use_iucn() ## End(Not run)## Not run: # Sign up for an API key rl_use_iucn() ## End(Not run)
Returns the current version number of the IUCN Red List of Threatened Species
rl_version(key = NULL, ...)rl_version(key = NULL, ...)
key |
(character) An IUCN API token. See |
... |
Curl options passed to |
Red List version as character string
Red List information and statistics:
rl_api_version(),
rl_citation(),
rl_sp_count()
## Not run: rl_version() ## End(Not run)## Not run: rl_version() ## End(Not run)