Species+/CITES Checklist API

Supported Formats

JSON, XML

>>>

GET api/v1/taxon_concepts/:taxon_concept_id/cites_legislation

cites_listings¶ ↑

id: these records may cascade from higher taxonomic level, so this value is inherited and the same record may be returned in different contexts.
taxon_concept_id: always present
is_current: boolean flag indicating whether listing chane is current
appendix: CITES appendix, one of I, II or III [max 255 characters]
change_type: type of listing change, one of:

+: inclusion in appendix,

-: removal from appendix,

R+: reservation entered,

R-: reservation withdrawn

effective_at: date when listing change came into effect, YYYY-MM-DD
party: where applicable, CITES party involved in the listing change. See description of geo_entity object below.
annotation: text of annotation (translated based on locale)
hash_annotation: where applicable, # annotation (plants). See description of annotation object below.

cites_quotas¶ ↑

id: these records may cascade from higher taxonomic level, so this value is inherited and the same record may be returned in different contexts.
taxon_concept_id: always present
quota: numeric value
publication_date: date when quota was published, YYYY-MM-DD
notes: comments [unlimited length]
url: URL of original document [unlimited length]
is_current: boolean flag indicating whether quota is current
unit: quota unit, see description of trade_code below
geo_entity: geographic location to which the quota applies. See description of geo_entity object below.

cites_suspensions¶ ↑

id: these records may cascade from higher taxonomic level, so this value is inherited and the same record may be returned in different contexts.
taxon_concept_id: empty when suspension applies to all taxa in given location
notes: comments [unlimited length]
start_date: date when suspension came into effect, YYYY-MM-DD
is_current: boolean flag indicating whether suspension is current
geo_entity: geographic location to which the suspension applies. See description of geo_entity object below.
applies_to_import: boolean flag which indcates whether suspension applies to import into the specified geographic location (applies to export by default).
start_notification: Suspension Notification document. See description of event object below.

geo_entity¶ ↑

iso_code2: ISO 3166-1 alpha-2 [max 255 characters]
name: name of country / territory (translated based on locale) [max 255 characters]
type: one of COUNTRY or TERRITORY [max 255 characters]

trade_code¶ ↑

code: CITES trade code [max 255 characters]
name: name (translated based on locale) [max 255 characters]

event¶ ↑

name: name of event [max 255 characters]
date: date of event
url: URL of document [unlimited length]

annotation¶ ↑

symbol: symbol of annotation [max 255 characters]
note: text of annotation (translated based on locale) [unlimited length]

Supported Formats

JSON, XML

Errors

400 Bad Request
401 Unauthorized
404 Not Found
422 Unprocessable Entity
500 Internal Server Error

{
  "cites_listings":[
    {
      "taxon_concept_id":4521,
      "is_current":true,
      "appendix":"II",
      "change_type":"+",
      "effective_at":"2007-09-13",
      "annotation":"The populations of Botswana, Namibia, South Africa and Zimbabwe are listed in Appendix II for the exclusive purpose of allowing: [...]"
    },
    {
      "taxon_concept_id":4521,
      "is_current":true,
      "appendix":"I",
      "change_type":"+",
      "effective_at":"2007-09-13",
      "annotation":"Included in Appendix I, except the populations of Botswana, Namibia, South Africa and Zimbabwe, which are included in Appendix II."
    },
    {
      "taxon_concept_id":4521,
      "is_current":true,
      "appendix":"I",
      "change_type":"R+",
      "effective_at":"1990-01-18",
      "annotation":null,
      "party":{
        "iso_code2":"MW",
        "name":"Malawi",
        "type":null
      }
    }
  ],
  "cites_quotas":[
    {
      "taxon_concept_id":4521,
      "quota":180.0,
      "publication_date":"2014-03-14",
      "notes":"tusks as trophies from 90 animals",
      "url":null,
      "public_display":true,
      "is_current":true,
      "unit":null,
      "geo_entity":{
        "iso_code2":"NA",
        "name":"Namibia",
        "type":"COUNTRY"
      }
    },
    {
      "taxon_concept_id":4521,
      "quota":160.0,
      "publication_date":"2014-03-14",
      "notes":"tusks as trophies from 80 animals",
      "url":null,
      "public_display":true,
      "is_current":true,
      "unit":null,
      "geo_entity":{
        "iso_code2":"CM",
        "name":"Cameroon",
        "type":"COUNTRY"
      }
    }
  ],
  "cites_suspensions":[
    {
      "taxon_concept_id":null,
      "notes":"All commercial trade in specimens of CITES-listed species.",
      "start_date":"2004-07-30",
      "is_current":true,
      "applies_to_import":false,
      "geo_entity":{
        "iso_code2":"SO",
        "name":"Somalia",
        "type":"COUNTRY"
      },
      "start_notification":{
        "name":"CITES Notif. No. 2004/055",
        "date":"2004-07-30",
        "url":"http://www.cites.org/eng/notif/2004/055.pdf"
      }
    },
    {
      "taxon_concept_id":4521,
      "notes":"The United States has suspended imports of sport-hunted trophies of African elephant taken in Zimbabwe on or after 4 April 2014.",
      "start_date":"2014-08-11",
      "is_current":true,
      "applies_to_import":false,
      "geo_entity":{
        "iso_code2":"ZW",
        "name":"Zimbabwe",
        "type":"COUNTRY"
      },
      "start_notification":{
        "name":"CITES Notif. No. 2014/037",
        "date":"2014-08-11",
        "url":"http://cites.org/sites/default/files/notif/E-Notif-2014-037.pdf"
      }
    }
  ]
}

<?xml version="1.0" encoding="UTF-8"?>
<cites-legislation>
  <cites-listings type="array">
    <cites-listing>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <is-current type="boolean">true</is-current>
      <appendix>II</appendix>
      <change-type>+</change-type>
      <effective-at type="date">2007-09-13</effective-at>
      <annotation>The populations of Botswana, Namibia, South Africa and Zimbabwe are listed in Appendix II for the exclusive purpose of allowing: [...]</annotation>
    </cites-listing>
    <cites-listing>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <is-current type="boolean">true</is-current>
      <appendix>I</appendix>
      <change-type>+</change-type>
      <effective-at type="date">2007-09-13</effective-at>
      <annotation>Included in Appendix I, except the populations of Botswana, Namibia, South Africa and Zimbabwe, which are included in Appendix II.</annotation>
    </cites-listing>
    <cites-listing>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <is-current type="boolean">true</is-current>
      <appendix>I</appendix>
      <change-type>R+</change-type>
      <effective-at type="date">1990-01-18</effective-at>
      <annotation nil="true"/>
      <party>
        <iso-code2>MW</iso-code2>
        <name>Malawi</name>
        <type nil="true"/>
      </party>
    </cites-listing>
  </cites-listings>
  <cites-quotas type="array">
    <cites-quota>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <quota type="float">180.0</quota>
      <publication-date type="date">2014-03-14</publication-date>
      <notes>tusks as trophies from 90 animals</notes>
      <url nil="true"/>
      <public-display type="boolean">true</public-display>
      <is-current type="boolean">true</is-current>
      <unit nil="true"/>
      <geo-entity>
        <iso-code2>NA</iso-code2>
        <name>Namibia</name>
        <type>COUNTRY</type>
      </geo-entity>
    </cites-quota>
    <cites-quota>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <quota type="float">160.0</quota>
      <publication-date type="date">2014-03-14</publication-date>
      <notes>tusks as trophies from 80 animals</notes>
      <url nil="true"/>
      <public-display type="boolean">true</public-display>
      <is-current type="boolean">true</is-current>
      <unit nil="true"/>
      <geo-entity>
        <iso-code2>CM</iso-code2>
        <name>Cameroon</name>
        <type>COUNTRY</type>
      </geo-entity>
    </cites-quota>
  </cites-quotas>
  <cites-suspensions type="array">
    <cites-suspension>
      <taxon-concept-id nil="true"/>
      <notes>All commercial trade in specimens of CITES-listed species.</notes>
      <start-date type="date">2004-07-30</start-date>
      <is-current type="boolean">true</is-current>
      <applies-to-import type="boolean">false</applies-to-import>
      <geo-entity>
        <iso-code2>SO</iso-code2>
        <name>Somalia</name>
        <type>COUNTRY</type>
      </geo-entity>
      <start-notification>
        <name>CITES Notif. No. 2004/055</name>
        <date>2004-07-30</date>
        <url>http://www.cites.org/eng/notif/2004/055.pdf</url>
      </start-notification>
    </cites-suspension>
    <cites-suspension>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <notes>The United States has suspended imports of sport-hunted trophies of African elephant taken in Zimbabwe on or after 4 April 2014.</notes>
      <start-date type="date">2014-08-11</start-date>
      <is-current type="boolean">true</is-current>
      <applies-to-import type="boolean">false</applies-to-import>
      <geo-entity>
        <iso-code2>ZW</iso-code2>
        <name>Zimbabwe</name>
        <type>COUNTRY</type>
      </geo-entity>
      <start-notification>
        <name>CITES Notif. No. 2014/037</name>
        <date>2014-08-11</date>
        <url>http://cites.org/sites/default/files/notif/E-Notif-2014-037.pdf</url>
      </start-notification>
    </cites-suspension>
  </cites-suspensions>
</cites-legislation>

Params

Param name	Description
taxon_concept_id required	Taxon Concept ID Value: Must be String
scope optional	Time scope of legislation. Select all, current or historic. Defaults to current. Value: Must be String
language optional	Select language for the text of legislation notes. Select en, fr, or es. Defaults to en. Value: Must be String