{"docs":{"name":"Species+/CITES Checklist API","info":"\n\u003cp\u003eAnother API description\u003c/p\u003e\n","copyright":"\u0026copy; 2026 UNEP-WCMC","doc_url":"/documentation/v1","api_url":"/api","resources":[{"doc_url":"/documentation/v1/cites_legislation","id":"cites_legislation","api_url":"/api","name":"CITES Legislation","short_description":null,"full_description":"","version":"v1","formats":["JSON","XML"],"metadata":null,"methods":[{"doc_url":"/documentation/v1/cites_legislation/index","name":"index","apis":[{"api_url":"api/v1/taxon_concepts/:taxon_concept_id/cites_legislation","http_method":"GET","short_description":"Lists current CITES appendix listings and reservations, CITES quotas, and CITES suspensions for a given taxon concept","deprecated":null}],"formats":["JSON","XML"],"full_description":"\n\u003ch4 id=\"label-cites_listings\"\u003ecites_listings\u003cspan\u003e\u003ca href=\"#label-cites_listings\"\u003e\u0026para;\u003c/a\u003e \u003ca href=\"#top\"\u003e\u0026uarr;\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\n\u003cdl class=\"rdoc-list label-list\"\u003e\u003cdt\u003eid\n\u003cdd\u003e\n\u003cp\u003ethese records may cascade from higher taxonomic level, so this value is inherited and the same record may be returned in different contexts.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003etaxon_concept_id\n\u003cdd\u003e\n\u003cp\u003ealways present\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eis_current\n\u003cdd\u003e\n\u003cp\u003eboolean flag indicating whether listing chane is current\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eappendix\n\u003cdd\u003e\n\u003cp\u003eCITES appendix, one of \u003ccode\u003eI\u003c/code\u003e, \u003ccode\u003eII\u003c/code\u003e or \u003ccode\u003eIII\u003c/code\u003e [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003echange_type\n\u003cdd\u003e\n\u003cp\u003etype of listing change, one of:\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e\n\n\u003cp\u003e\u003ccode\u003e+\u003c/code\u003e: inclusion in appendix,\u003c/p\u003e\n\n\u003cp\u003e\u003ccode\u003e-\u003c/code\u003e: removal from appendix,\u003c/p\u003e\n\n\u003cp\u003e\u003ccode\u003eR+\u003c/code\u003e: reservation entered,\u003c/p\u003e\n\n\u003cp\u003e\u003ccode\u003eR-\u003c/code\u003e: reservation withdrawn\u003c/p\u003e\n\u003cdl class=\"rdoc-list label-list\"\u003e\u003cdt\u003eeffective_at\n\u003cdd\u003e\n\u003cp\u003edate when listing change came into effect, YYYY-MM-DD\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eparty\n\u003cdd\u003e\n\u003cp\u003ewhere applicable, CITES party involved in the listing change. See description of \u003ccode\u003egeo_entity\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eannotation\n\u003cdd\u003e\n\u003cp\u003etext of annotation (translated based on locale)\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003ehash_annotation\n\u003cdd\u003e\n\u003cp\u003ewhere applicable, \u003ccode\u003e#\u003c/code\u003e annotation (plants). See description of \u003ccode\u003eannotation\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e\n\n\u003ch4 id=\"label-cites_quotas\"\u003ecites_quotas\u003cspan\u003e\u003ca href=\"#label-cites_quotas\"\u003e\u0026para;\u003c/a\u003e \u003ca href=\"#top\"\u003e\u0026uarr;\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\n\u003cdl class=\"rdoc-list label-list\"\u003e\u003cdt\u003eid\n\u003cdd\u003e\n\u003cp\u003ethese records may cascade from higher taxonomic level, so this value is inherited and the same record may be returned in different contexts.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003etaxon_concept_id\n\u003cdd\u003e\n\u003cp\u003ealways present\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003equota\n\u003cdd\u003e\n\u003cp\u003enumeric value\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003epublication_date\n\u003cdd\u003e\n\u003cp\u003edate when quota was published, YYYY-MM-DD\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003enotes\n\u003cdd\u003e\n\u003cp\u003ecomments [unlimited length]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eurl\n\u003cdd\u003e\n\u003cp\u003eURL of original document [unlimited length]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eis_current\n\u003cdd\u003e\n\u003cp\u003eboolean flag indicating whether quota is current\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eunit\n\u003cdd\u003e\n\u003cp\u003equota unit, see description of \u003ccode\u003etrade_code\u003c/code\u003e below\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003egeo_entity\n\u003cdd\u003e\n\u003cp\u003egeographic location to which the quota applies. See description of \u003ccode\u003egeo_entity\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e\n\n\u003ch4 id=\"label-cites_suspensions\"\u003ecites_suspensions\u003cspan\u003e\u003ca href=\"#label-cites_suspensions\"\u003e\u0026para;\u003c/a\u003e \u003ca href=\"#top\"\u003e\u0026uarr;\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\n\u003cdl class=\"rdoc-list label-list\"\u003e\u003cdt\u003eid\n\u003cdd\u003e\n\u003cp\u003ethese records may cascade from higher taxonomic level, so this value is inherited and the same record may be returned in different contexts.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003etaxon_concept_id\n\u003cdd\u003e\n\u003cp\u003eempty when suspension applies to all taxa in given location\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003enotes\n\u003cdd\u003e\n\u003cp\u003ecomments [unlimited length]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003estart_date\n\u003cdd\u003e\n\u003cp\u003edate when suspension came into effect, YYYY-MM-DD\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eis_current\n\u003cdd\u003e\n\u003cp\u003eboolean flag indicating whether suspension is current\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003egeo_entity\n\u003cdd\u003e\n\u003cp\u003egeographic location to which the suspension applies. See description of \u003ccode\u003egeo_entity\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eapplies_to_import\n\u003cdd\u003e\n\u003cp\u003eboolean flag which indcates whether suspension applies to import into the specified geographic location (applies to export by default).\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003estart_notification\n\u003cdd\u003e\n\u003cp\u003eSuspension Notification document. See description of \u003ccode\u003eevent\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e\n\n\u003ch4 id=\"label-geo_entity\"\u003egeo_entity\u003cspan\u003e\u003ca href=\"#label-geo_entity\"\u003e\u0026para;\u003c/a\u003e \u003ca href=\"#top\"\u003e\u0026uarr;\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\n\u003cdl class=\"rdoc-list label-list\"\u003e\u003cdt\u003eiso_code2\n\u003cdd\u003e\n\u003cp\u003eISO 3166-1 alpha-2 [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003ename\n\u003cdd\u003e\n\u003cp\u003ename of country / territory (translated based on locale) [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003etype\n\u003cdd\u003e\n\u003cp\u003eone of \u003ccode\u003eCOUNTRY\u003c/code\u003e or \u003ccode\u003eTERRITORY\u003c/code\u003e [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e\n\n\u003ch4 id=\"label-trade_code\"\u003etrade_code\u003cspan\u003e\u003ca href=\"#label-trade_code\"\u003e\u0026para;\u003c/a\u003e \u003ca href=\"#top\"\u003e\u0026uarr;\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\n\u003cdl class=\"rdoc-list label-list\"\u003e\u003cdt\u003ecode\n\u003cdd\u003e\n\u003cp\u003eCITES trade code [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003ename\n\u003cdd\u003e\n\u003cp\u003ename (translated based on locale) [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e\n\n\u003ch4 id=\"label-event\"\u003eevent\u003cspan\u003e\u003ca href=\"#label-event\"\u003e\u0026para;\u003c/a\u003e \u003ca href=\"#top\"\u003e\u0026uarr;\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\n\u003cdl class=\"rdoc-list label-list\"\u003e\u003cdt\u003ename\n\u003cdd\u003e\n\u003cp\u003ename of event [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003edate\n\u003cdd\u003e\n\u003cp\u003edate of event\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eurl\n\u003cdd\u003e\n\u003cp\u003eURL of document [unlimited length]\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e\n\n\u003ch4 id=\"label-annotation\"\u003eannotation\u003cspan\u003e\u003ca href=\"#label-annotation\"\u003e\u0026para;\u003c/a\u003e \u003ca href=\"#top\"\u003e\u0026uarr;\u003c/a\u003e\u003c/span\u003e\u003c/h4\u003e\n\u003cdl class=\"rdoc-list label-list\"\u003e\u003cdt\u003esymbol\n\u003cdd\u003e\n\u003cp\u003esymbol of annotation [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003enote\n\u003cdd\u003e\n\u003cp\u003etext of annotation (translated based on locale) [unlimited length]\u003c/p\u003e\n\u003c/dd\u003e\u003c/dl\u003e\n","errors":[{"code":400,"description":"Bad Request","metadata":null},{"code":401,"description":"Unauthorized","metadata":null},{"code":404,"description":"Not Found","metadata":null},{"code":422,"description":"Unprocessable Entity","metadata":null},{"code":500,"description":"Internal Server Error","metadata":null}],"params":[{"name":"taxon_concept_id","full_name":"taxon_concept_id","description":"\n\u003cp\u003eTaxon Concept ID\u003c/p\u003e\n","required":true,"allow_nil":false,"allow_blank":false,"validator":"Must be a String","expected_type":"string","metadata":null,"show":true,"validations":[],"deprecated":false},{"name":"scope","full_name":"scope","description":"\n\u003cp\u003eTime scope of legislation. Select all, current or historic. Defaults to current.\u003c/p\u003e\n","required":false,"allow_nil":false,"allow_blank":false,"validator":"Must be a String","expected_type":"string","metadata":null,"show":true,"validations":[],"deprecated":false},{"name":"language","full_name":"language","description":"\n\u003cp\u003eSelect language for the text of legislation notes. Select en, fr, or es. Defaults to en.\u003c/p\u003e\n","required":false,"allow_nil":false,"allow_blank":false,"validator":"Must be a String","expected_type":"string","metadata":null,"show":true,"validations":[],"deprecated":false}],"returns":[],"examples":["{\n  \"cites_listings\":[\n    {\n      \"taxon_concept_id\":4521,\n      \"is_current\":true,\n      \"appendix\":\"II\",\n      \"change_type\":\"+\",\n      \"effective_at\":\"2007-09-13\",\n      \"annotation\":\"The populations of Botswana, Namibia, South Africa and Zimbabwe are listed in Appendix II for the exclusive purpose of allowing: [...]\"\n    },\n    {\n      \"taxon_concept_id\":4521,\n      \"is_current\":true,\n      \"appendix\":\"I\",\n      \"change_type\":\"+\",\n      \"effective_at\":\"2007-09-13\",\n      \"annotation\":\"Included in Appendix I, except the populations of Botswana, Namibia, South Africa and Zimbabwe, which are included in Appendix II.\"\n    },\n    {\n      \"taxon_concept_id\":4521,\n      \"is_current\":true,\n      \"appendix\":\"I\",\n      \"change_type\":\"R+\",\n      \"effective_at\":\"1990-01-18\",\n      \"annotation\":null,\n      \"party\":{\n        \"iso_code2\":\"MW\",\n        \"name\":\"Malawi\",\n        \"type\":null\n      }\n    }\n  ],\n  \"cites_quotas\":[\n    {\n      \"taxon_concept_id\":4521,\n      \"quota\":180.0,\n      \"publication_date\":\"2014-03-14\",\n      \"notes\":\"tusks as trophies from 90 animals\",\n      \"url\":null,\n      \"public_display\":true,\n      \"is_current\":true,\n      \"unit\":null,\n      \"geo_entity\":{\n        \"iso_code2\":\"NA\",\n        \"name\":\"Namibia\",\n        \"type\":\"COUNTRY\"\n      }\n    },\n    {\n      \"taxon_concept_id\":4521,\n      \"quota\":160.0,\n      \"publication_date\":\"2014-03-14\",\n      \"notes\":\"tusks as trophies from 80 animals\",\n      \"url\":null,\n      \"public_display\":true,\n      \"is_current\":true,\n      \"unit\":null,\n      \"geo_entity\":{\n        \"iso_code2\":\"CM\",\n        \"name\":\"Cameroon\",\n        \"type\":\"COUNTRY\"\n      }\n    }\n  ],\n  \"cites_suspensions\":[\n    {\n      \"taxon_concept_id\":null,\n      \"notes\":\"All commercial trade in specimens of CITES-listed species.\",\n      \"start_date\":\"2004-07-30\",\n      \"is_current\":true,\n      \"applies_to_import\":false,\n      \"geo_entity\":{\n        \"iso_code2\":\"SO\",\n        \"name\":\"Somalia\",\n        \"type\":\"COUNTRY\"\n      },\n      \"start_notification\":{\n        \"name\":\"CITES Notif. No. 2004/055\",\n        \"date\":\"2004-07-30\",\n        \"url\":\"http://www.cites.org/eng/notif/2004/055.pdf\"\n      }\n    },\n    {\n      \"taxon_concept_id\":4521,\n      \"notes\":\"The United States has suspended imports of sport-hunted trophies of African elephant taken in Zimbabwe on or after 4 April 2014.\",\n      \"start_date\":\"2014-08-11\",\n      \"is_current\":true,\n      \"applies_to_import\":false,\n      \"geo_entity\":{\n        \"iso_code2\":\"ZW\",\n        \"name\":\"Zimbabwe\",\n        \"type\":\"COUNTRY\"\n      },\n      \"start_notification\":{\n        \"name\":\"CITES Notif. No. 2014/037\",\n        \"date\":\"2014-08-11\",\n        \"url\":\"http://cites.org/sites/default/files/notif/E-Notif-2014-037.pdf\"\n      }\n    }\n  ]\n}\n","\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003ccites-legislation\u003e\n  \u003ccites-listings type=\"array\"\u003e\n    \u003ccites-listing\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003cappendix\u003eII\u003c/appendix\u003e\n      \u003cchange-type\u003e+\u003c/change-type\u003e\n      \u003ceffective-at type=\"date\"\u003e2007-09-13\u003c/effective-at\u003e\n      \u003cannotation\u003eThe populations of Botswana, Namibia, South Africa and Zimbabwe are listed in Appendix II for the exclusive purpose of allowing: [...]\u003c/annotation\u003e\n    \u003c/cites-listing\u003e\n    \u003ccites-listing\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003cappendix\u003eI\u003c/appendix\u003e\n      \u003cchange-type\u003e+\u003c/change-type\u003e\n      \u003ceffective-at type=\"date\"\u003e2007-09-13\u003c/effective-at\u003e\n      \u003cannotation\u003eIncluded in Appendix I, except the populations of Botswana, Namibia, South Africa and Zimbabwe, which are included in Appendix II.\u003c/annotation\u003e\n    \u003c/cites-listing\u003e\n    \u003ccites-listing\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003cappendix\u003eI\u003c/appendix\u003e\n      \u003cchange-type\u003eR+\u003c/change-type\u003e\n      \u003ceffective-at type=\"date\"\u003e1990-01-18\u003c/effective-at\u003e\n      \u003cannotation nil=\"true\"/\u003e\n      \u003cparty\u003e\n        \u003ciso-code2\u003eMW\u003c/iso-code2\u003e\n        \u003cname\u003eMalawi\u003c/name\u003e\n        \u003ctype nil=\"true\"/\u003e\n      \u003c/party\u003e\n    \u003c/cites-listing\u003e\n  \u003c/cites-listings\u003e\n  \u003ccites-quotas type=\"array\"\u003e\n    \u003ccites-quota\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cquota type=\"float\"\u003e180.0\u003c/quota\u003e\n      \u003cpublication-date type=\"date\"\u003e2014-03-14\u003c/publication-date\u003e\n      \u003cnotes\u003etusks as trophies from 90 animals\u003c/notes\u003e\n      \u003curl nil=\"true\"/\u003e\n      \u003cpublic-display type=\"boolean\"\u003etrue\u003c/public-display\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003cunit nil=\"true\"/\u003e\n      \u003cgeo-entity\u003e\n        \u003ciso-code2\u003eNA\u003c/iso-code2\u003e\n        \u003cname\u003eNamibia\u003c/name\u003e\n        \u003ctype\u003eCOUNTRY\u003c/type\u003e\n      \u003c/geo-entity\u003e\n    \u003c/cites-quota\u003e\n    \u003ccites-quota\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cquota type=\"float\"\u003e160.0\u003c/quota\u003e\n      \u003cpublication-date type=\"date\"\u003e2014-03-14\u003c/publication-date\u003e\n      \u003cnotes\u003etusks as trophies from 80 animals\u003c/notes\u003e\n      \u003curl nil=\"true\"/\u003e\n      \u003cpublic-display type=\"boolean\"\u003etrue\u003c/public-display\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003cunit nil=\"true\"/\u003e\n      \u003cgeo-entity\u003e\n        \u003ciso-code2\u003eCM\u003c/iso-code2\u003e\n        \u003cname\u003eCameroon\u003c/name\u003e\n        \u003ctype\u003eCOUNTRY\u003c/type\u003e\n      \u003c/geo-entity\u003e\n    \u003c/cites-quota\u003e\n  \u003c/cites-quotas\u003e\n  \u003ccites-suspensions type=\"array\"\u003e\n    \u003ccites-suspension\u003e\n      \u003ctaxon-concept-id nil=\"true\"/\u003e\n      \u003cnotes\u003eAll commercial trade in specimens of CITES-listed species.\u003c/notes\u003e\n      \u003cstart-date type=\"date\"\u003e2004-07-30\u003c/start-date\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003capplies-to-import type=\"boolean\"\u003efalse\u003c/applies-to-import\u003e\n      \u003cgeo-entity\u003e\n        \u003ciso-code2\u003eSO\u003c/iso-code2\u003e\n        \u003cname\u003eSomalia\u003c/name\u003e\n        \u003ctype\u003eCOUNTRY\u003c/type\u003e\n      \u003c/geo-entity\u003e\n      \u003cstart-notification\u003e\n        \u003cname\u003eCITES Notif. No. 2004/055\u003c/name\u003e\n        \u003cdate\u003e2004-07-30\u003c/date\u003e\n        \u003curl\u003ehttp://www.cites.org/eng/notif/2004/055.pdf\u003c/url\u003e\n      \u003c/start-notification\u003e\n    \u003c/cites-suspension\u003e\n    \u003ccites-suspension\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cnotes\u003eThe United States has suspended imports of sport-hunted trophies of African elephant taken in Zimbabwe on or after 4 April 2014.\u003c/notes\u003e\n      \u003cstart-date type=\"date\"\u003e2014-08-11\u003c/start-date\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003capplies-to-import type=\"boolean\"\u003efalse\u003c/applies-to-import\u003e\n      \u003cgeo-entity\u003e\n        \u003ciso-code2\u003eZW\u003c/iso-code2\u003e\n        \u003cname\u003eZimbabwe\u003c/name\u003e\n        \u003ctype\u003eCOUNTRY\u003c/type\u003e\n      \u003c/geo-entity\u003e\n      \u003cstart-notification\u003e\n        \u003cname\u003eCITES Notif. No. 2014/037\u003c/name\u003e\n        \u003cdate\u003e2014-08-11\u003c/date\u003e\n        \u003curl\u003ehttp://cites.org/sites/default/files/notif/E-Notif-2014-037.pdf\u003c/url\u003e\n      \u003c/start-notification\u003e\n    \u003c/cites-suspension\u003e\n  \u003c/cites-suspensions\u003e\n\u003c/cites-legislation\u003e\n"],"metadata":null,"see":[],"headers":[],"show":true}],"headers":[],"deprecated":false}]}}