rcites v1.1.0


Monthly downloads



R Interface to the Species+ Database

A programmatic interface to the Species+ <https://speciesplus.net/> database via the Species+/CITES Checklist API <https://api.speciesplus.net/>.



Build status Build status codecov status Project Status: Active – The project has reached a stable, usable state and is being actively developed. ROpenSci status CRAN status CRAN downloads Zenodo DOI JOSS DOI

An R package to access information from the Speciesplus database via the Speciesplus/CITES Checklist API. The package is available for download from CRAN (stable version) and Github (development version).

Please see the release paper for background information about the Convention on International Trade in Endangered Species of Wild Fauna and Flora (CITES), the Speciesplus database and basic information about the aim of the package.


The package can be installed from CRAN:


The development version can be installed via the remotes :package:


Setup requirements and use

To set up a connection to the CITES Speciesplus database, a personal authentication token is required. Please see the vignette for details how to get a token and how to set the token for package use: Get started with rcites

Additional information about specific use examples are provided for the African bush elephant (Loxodonta africana). The package usage for querying multiple species is described in another vignette entitled 'Bulk analysis with rcites'.

Key features

Once the token is set, the package has five key features:

Prefix information

The package functions have three different prefixes:

  • set_ for set_token() to initially set the API token
  • spp_ for the key features
  • rcites_ for helper functions that are called within the key features

Citation information

When citing, please refer to both the package citation and the release paper.



Another package dealing with data from and about CITES, providing access to its wildlife trade database: cites

While creating this package, we greatly benefited from:

  1. taxize that inspired the structuring of this repository/package;

  2. the httr vignette: Managing secrets, which is extremely helpful for packages dealing with API.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Also, please read the Terms and Conditions of Use of Speciesplus Data: https://speciesplus.net/terms-of-use.


Functions in rcites

Name Description
rcites rcites
spp_taxonconcept Get taxon concepts for a search term
spp_eu_legislation Get current EU annex listings, SRG opinions, and EU suspensions
spp_cites_legislation Get current CITES appendix listings and reservations
set_token Login helper function
print.spp Print methods for objects of class spp_raw*.
spp_references Get references for a given taxon concept
spp_distributions Get distributions data available for a given taxon concept
No Results!

Vignettes of rcites

No Results!

Last month downloads


Type Package
URL https://docs.ropensci.org/rcites/, https://github.com/ropensci/rcites
BugReports https://github.com/ropensci/rcites/issues
License MIT + file LICENSE
Encoding UTF-8
RoxygenNote 7.1.0
VignetteBuilder knitr
NeedsCompilation no
Packaged 2020-07-01 13:59:52 UTC; kevcaz
Repository CRAN
Date/Publication 2020-07-01 15:10:03 UTC

Include our badge in your README