[GET] api/v1/downloads

Note: This feature is in beta and may change based on feedback.

Downloads are prepared weekly so there may be some small inconsistencies when compared to the latest data available from other API calls. The response itself contains the timestamp at which the download was built. The download URL is generated on request and has an expiry time.

Downloadable files are available as gzipped, newline-delimited JSON only, regardless of whether this metadata endpoint was retrieved as JSON or XML.

GET /api/v1/downloads/latest will return a redirect to the latest download.

lang

ISO 2-letter code indicating the language in which annotations will be returned - should be one of en, fr, es. Note that common names for all languages will be reported regardless of this field.

Supported Formats

Errors

Examples

[
  {
    "id": 5,
    "filters": {
      "lang": "en",
      "taxonomy": "CITES_EU"
    },
    "format": "application/x-gzip-compressed",
    "started_at": "2025-04-01T16:00:17.463Z",
    "success_message": {
      "stats": {
        "elapsed_time": 299.37821418899875,
        "record_count": 89616,
        "compressed_bytes": 49427903,
        "uncompressed_bytes": 362830553
      }
    },
    "download_url": "https://api.speciesplus.net/.../cites_eu_en.ndjson.gz"
  }
]

<?xml version="1.0" encoding="UTF-8"?>
<bulk-downloads type="array">
  <bulk-download>
    <id type="integer">5</id>
    <filters>
      <lang>en</lang>
      <taxonomy>CITES_EU</taxonomy>
    </filters>
    <format>application/x-gzip-compressed</format>
    <started-at type="dateTime">2025-04-01T16:00:17Z</started-at>
    <success-message>
      <stats>
        <elapsed-time type="float">299.37821418899875</elapsed-time>
        <record-count type="integer">89616</record-count>
        <compressed-bytes type="integer">49427903</compressed-bytes>
        <uncompressed-bytes type="integer">362830553</uncompressed-bytes>
      </stats>
    </success-message>
    <download-url>https://api.speciesplus.net/.../cites_eu_en.ndjson.gz</download-url>
  </bulk-download>
</bulk-downloads>

Params