{"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/eu_legislation","id":"eu_legislation","api_url":"/api","name":"EU Legislation","short_description":null,"full_description":"","version":"v1","formats":["JSON","XML"],"metadata":null,"methods":[{"doc_url":"/documentation/v1/eu_legislation/index","name":"index","apis":[{"api_url":"api/v1/taxon_concepts/:taxon_concept_id/eu_legislation","http_method":"GET","short_description":"Lists current EU annex listings, SRG opinions, and EU suspensions for a given taxon concept","deprecated":null}],"formats":["JSON","XML"],"full_description":"\n\u003ch4 id=\"label-eu_listings\"\u003eeu_listings\u003cspan\u003e\u003ca href=\"#label-eu_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 change is current\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eannex\n\u003cdd\u003e\n\u003cp\u003eEU annex, one of \u003ccode\u003eA\u003c/code\u003e, \u003ccode\u003eB\u003c/code\u003e, \u003ccode\u003eC\u003c/code\u003e, \u003ccode\u003eD\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 annex,\u003c/p\u003e\n\n\u003cp\u003e\u003ccode\u003e-\u003c/code\u003e: removal from annex\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, 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-eu_decisions\"\u003eeu_decisions\u003cspan\u003e\u003ca href=\"#label-eu_decisions\"\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\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 decision 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 decision is current\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eeu_decision_type\n\u003cdd\u003e\n\u003cp\u003etype of decision. See description of eu_decision_type object below.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003egeo_entity\n\u003cdd\u003e\n\u003cp\u003egeographic location to which the decision applies. See description of \u003ccode\u003egeo_entity\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003estart_event\n\u003cdd\u003e\n\u003cp\u003eevent that started the suspension. See description of \u003ccode\u003eevent\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eend_event\n\u003cdd\u003e\n\u003cp\u003eevent that ended the suspension. See description of \u003ccode\u003eevent\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003esource\n\u003cdd\u003e\n\u003cp\u003esource to which decision applies. See description of \u003ccode\u003etrade_code\u003c/code\u003e object below.\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003eterm\n\u003cdd\u003e\n\u003cp\u003eterm to which decision applies. See description of \u003ccode\u003etrade_code\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\n\u003ch4 id=\"label-eu_decision_type\"\u003eeu_decision_type\u003cspan\u003e\u003ca href=\"#label-eu_decision_type\"\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 decision type, e.g. \u003ccode\u003eSuspension (a)\u003c/code\u003e, \u003ccode\u003eNegative\u003c/code\u003e, \u003ccode\u003eNo opinion\u003c/code\u003e [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003edescription\n\u003cdd\u003e\n\u003cp\u003eadditional description where available [max 255 characters]\u003c/p\u003e\n\u003c/dd\u003e\u003cdt\u003etype\n\u003cdd\u003e\n\u003cp\u003eone of \u003ccode\u003eSUSPENSION\u003c/code\u003e, \u003ccode\u003ePOSITIVE_OPINION\u003c/code\u003e, \u003ccode\u003eNEGATIVE_OPINION\u003c/code\u003e, \u003ccode\u003eNO_OPINION\u003c/code\u003e [max 255 characters]\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    \"eu_listings\":[\n      {\n        \"taxon_concept_id\":4521,\n        \"is_current\":true,\n        \"annex\":\"B\",\n        \"change_type\":\"+\",\n        \"effective_at\":\"2013-08-10\",\n        \"annotation\":\"Populations of Botswana, Namibia, South Africa and Zimbabwe (listed in Annex B):\n\nFor the exclusive purpose of allowing: [...]\"\n      },\n      {\n        \"taxon_concept_id\":4521,\n        \"is_current\":true,\n        \"annex\":\"A\",\n        \"change_type\":\"+\",\n        \"effective_at\":\"2013-08-10\",\n        \"annotation\":\"All populations except those of Botswana, Namibia, South Africa and Zimbabwe.\"\n      }\n    ],\n    \"eu_decisions\":[\n      {\n        \"taxon_concept_id\":4521,\n        \"notes\":\"\",\n        \"start_date\":\"2014-09-03\",\n        \"is_current\":true,\n        \"eu_decision_type\":{\n          \"name\":\"Positive\",\n          \"description\":null,\n          \"type\":\"POSITIVE_OPINION\"\n        },\n        \"geo_entity\":{\n          \"iso_code2\":\"BW\",\n          \"name\":\"Botswana\",\n          \"type\":\"COUNTRY\"\n        },\n        \"start_event\":{\n          \"name\":\"No 338/97\",\n          \"date\":\"1997-06-01\",\n          \"url\":\"http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CONSLEG:1997R0338:20080411:EN:PDF\"\n        },\n        \"source\":{\n          \"code\":\"W\",\n          \"name\":\"Wild\"\n        },\n        \"term\":{\n          \"code\":null,\n          \"name\":null\n        }\n      },\n      {\n        \"taxon_concept_id\":4521,\n        \"notes\":null,\n        \"start_date\":\"2011-12-02\",\n        \"is_current\":true,\n        \"eu_decision_type\":{\n          \"name\":\"i)\",\n          \"description\":\"no significant trade anticipated\",\n          \"type\":\"NO_OPINION\"\n        },\n        \"geo_entity\":{\n          \"iso_code2\":\"ET\",\n          \"name\":\"Ethiopia\",\n          \"type\":\"COUNTRY\"\n        },\n        \"start_event\":{\n          \"name\":\"No 338/97\",\n          \"date\":\"1997-06-01\",\n          \"url\":\"http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CONSLEG:1997R0338:20080411:EN:PDF\"\n        },\n        \"source\":{\n          \"code\":null,\n          \"name\":null\n        },\n        \"term\":{\n          \"code\":null,\n          \"name\":null\n        }\n      },\n      {\n        \"taxon_concept_id\":4521,\n        \"notes\":\"Hunting trophies\",\n        \"start_date\":\"2014-09-04\",\n        \"is_current\":true,\n        \"eu_decision_type\":{\n          \"name\":\"Suspension (a)\",\n          \"description\":null,\n          \"type\":\"SUSPENSION\"\n        },\n        \"geo_entity\":{\n          \"iso_code2\":\"CM\",\n          \"name\":\"Cameroon\",\n          \"type\":\"COUNTRY\"\n        },\n        \"start_event\":{\n          \"name\":\"No 888/2014\",\n          \"date\":\"2014-09-04\",\n          \"url\":\"http://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32014R0888\u0026from=EN\"\n        },\n        \"source\":{\n          \"code\":\"W\",\n          \"name\":\"Wild\"\n        },\n        \"term\":{\n          \"code\":null,\n          \"name\":null\n        }\n      }\n    ]\n  }\n","\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003ceu-legislation\u003e\n  \u003ceu-listings type=\"array\"\u003e\n    \u003ceu-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      \u003cannex\u003eB\u003c/annex\u003e\n      \u003cchange-type\u003e+\u003c/change-type\u003e\n      \u003ceffective-at type=\"date\"\u003e2013-08-10\u003c/effective-at\u003e\n      \u003cannotation\u003ePopulations of Botswana, Namibia, South Africa and Zimbabwe (listed in Annex B):\n\nFor the exclusive purpose of allowing: [...]\u003c/annotation\u003e\n    \u003c/eu-listing\u003e\n    \u003ceu-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      \u003cannex\u003eA\u003c/annex\u003e\n      \u003cchange-type\u003e+\u003c/change-type\u003e\n      \u003ceffective-at type=\"date\"\u003e2013-08-10\u003c/effective-at\u003e\n      \u003cannotation\u003eAll populations except those of Botswana, Namibia, South Africa and Zimbabwe.\u003c/annotation\u003e\n    \u003c/eu-listing\u003e\n  \u003c/eu-listings\u003e\n  \u003ceu-decisions type=\"array\"\u003e\n    \u003ceu-decision\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cnotes\u003e\u003c/notes\u003e\n      \u003cstart-date type=\"date\"\u003e2014-09-03\u003c/start-date\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003ceu-decision-type\u003e\n        \u003cname\u003ePositive\u003c/name\u003e\n        \u003cdescription nil=\"true\"/\u003e\n        \u003ctype\u003ePOSITIVE_OPINION\u003c/type\u003e\n      \u003c/eu-decision-type\u003e\n      \u003cgeo-entity\u003e\n        \u003ciso-code2\u003eBW\u003c/iso-code2\u003e\n        \u003cname\u003eBotswana\u003c/name\u003e\n        \u003ctype\u003eCOUNTRY\u003c/type\u003e\n      \u003c/geo-entity\u003e\n      \u003cstart-event\u003e\n        \u003cname\u003eNo 338/97\u003c/name\u003e\n        \u003cdate\u003e1997-06-01\u003c/date\u003e\n        \u003curl\u003ehttp://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CONSLEG:1997R0338:20080411:EN:PDF\u003c/url\u003e\n      \u003c/start-event\u003e\n      \u003csource\u003e\n        \u003ccode\u003eW\u003c/code\u003e\n        \u003cname\u003eWild\u003c/name\u003e\n      \u003c/source\u003e\n      \u003cterm\u003e\n        \u003ccode nil=\"true\"/\u003e\n        \u003cname nil=\"true\"/\u003e\n      \u003c/term\u003e\n    \u003c/eu-decision\u003e\n    \u003ceu-decision\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cnotes nil=\"true\"/\u003e\n      \u003cstart-date type=\"date\"\u003e2011-12-02\u003c/start-date\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003ceu-decision-type\u003e\n        \u003cname\u003ei)\u003c/name\u003e\n        \u003cdescription\u003eno significant trade anticipated\u003c/description\u003e\n        \u003ctype\u003eNO_OPINION\u003c/type\u003e\n      \u003c/eu-decision-type\u003e\n      \u003cgeo-entity\u003e\n        \u003ciso-code2\u003eET\u003c/iso-code2\u003e\n        \u003cname\u003eEthiopia\u003c/name\u003e\n        \u003ctype\u003eCOUNTRY\u003c/type\u003e\n      \u003c/geo-entity\u003e\n      \u003cstart-event\u003e\n        \u003cname\u003eNo 338/97\u003c/name\u003e\n        \u003cdate\u003e1997-06-01\u003c/date\u003e\n        \u003curl\u003ehttp://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CONSLEG:1997R0338:20080411:EN:PDF\u003c/url\u003e\n      \u003c/start-event\u003e\n      \u003csource\u003e\n        \u003ccode nil=\"true\"/\u003e\n        \u003cname nil=\"true\"/\u003e\n      \u003c/source\u003e\n      \u003cterm\u003e\n        \u003ccode nil=\"true\"/\u003e\n        \u003cname nil=\"true\"/\u003e\n      \u003c/term\u003e\n    \u003c/eu-decision\u003e\n    \u003ceu-decision\u003e\n      \u003ctaxon-concept-id type=\"integer\"\u003e4521\u003c/taxon-concept-id\u003e\n      \u003cnotes\u003eHunting trophies\u003c/notes\u003e\n      \u003cstart-date type=\"date\"\u003e2014-09-04\u003c/start-date\u003e\n      \u003cis-current type=\"boolean\"\u003etrue\u003c/is-current\u003e\n      \u003ceu-decision-type\u003e\n        \u003cname\u003eSuspension (a)\u003c/name\u003e\n        \u003cdescription nil=\"true\"/\u003e\n        \u003ctype\u003eSUSPENSION\u003c/type\u003e\n      \u003c/eu-decision-type\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      \u003cstart-event\u003e\n        \u003cname\u003eNo 888/2014\u003c/name\u003e\n        \u003cdate\u003e2014-09-04\u003c/date\u003e\n        \u003curl\u003ehttp://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32014R0888\u0026amp;from=EN\u003c/url\u003e\n      \u003c/start-event\u003e\n      \u003csource\u003e\n        \u003ccode\u003eW\u003c/code\u003e\n        \u003cname\u003eWild\u003c/name\u003e\n      \u003c/source\u003e\n      \u003cterm\u003e\n        \u003ccode nil=\"true\"/\u003e\n        \u003cname nil=\"true\"/\u003e\n      \u003c/term\u003e\n    \u003c/eu-decision\u003e\n  \u003c/eu-decisions\u003e\n\u003c/eu-legislation\u003e\n"],"metadata":null,"see":[],"headers":[],"show":true}],"headers":[],"deprecated":false}]}}