Species+/CITES Checklist API

Supported Formats

JSON, XML

>>>

GET api/v1/taxon_concepts/:taxon_concept_id/eu_legislation

eu_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 change is current
annex: EU annex, one of A, B, C, D [max 255 characters]
change_type: type of listing change, one of:

+: inclusion in annex,

-: removal from annex

effective_at: date when listing change came into effect, YYYY-MM-DD
party: where applicable, 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.

eu_decisions¶ ↑

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
notes: comments [unlimited length]
start_date: date when decision came into effect, YYYY-MM-DD
is_current: boolean flag indicating whether decision is current
eu_decision_type: type of decision. See description of eu_decision_type object below.
geo_entity: geographic location to which the decision applies. See description of geo_entity object below.
start_event: event that started the suspension. See description of event object below.
end_event: event that ended the suspension. See description of event object below.
source: source to which decision applies. See description of trade_code object below.
term: term to which decision applies. See description of trade_code 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]

eu_decision_type¶ ↑

name: name of decision type, e.g. Suspension (a), Negative, No opinion [max 255 characters]
description: additional description where available [max 255 characters]
type: one of SUSPENSION, POSITIVE_OPINION, NEGATIVE_OPINION, NO_OPINION [max 255 characters]

Supported Formats

JSON, XML

Errors

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

  {
    "eu_listings":[
      {
        "taxon_concept_id":4521,
        "is_current":true,
        "annex":"B",
        "change_type":"+",
        "effective_at":"2013-08-10",
        "annotation":"Populations of Botswana, Namibia, South Africa and Zimbabwe (listed in Annex B):

For the exclusive purpose of allowing: [...]"
      },
      {
        "taxon_concept_id":4521,
        "is_current":true,
        "annex":"A",
        "change_type":"+",
        "effective_at":"2013-08-10",
        "annotation":"All populations except those of Botswana, Namibia, South Africa and Zimbabwe."
      }
    ],
    "eu_decisions":[
      {
        "taxon_concept_id":4521,
        "notes":"",
        "start_date":"2014-09-03",
        "is_current":true,
        "eu_decision_type":{
          "name":"Positive",
          "description":null,
          "type":"POSITIVE_OPINION"
        },
        "geo_entity":{
          "iso_code2":"BW",
          "name":"Botswana",
          "type":"COUNTRY"
        },
        "start_event":{
          "name":"No 338/97",
          "date":"1997-06-01",
          "url":"http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CONSLEG:1997R0338:20080411:EN:PDF"
        },
        "source":{
          "code":"W",
          "name":"Wild"
        },
        "term":{
          "code":null,
          "name":null
        }
      },
      {
        "taxon_concept_id":4521,
        "notes":null,
        "start_date":"2011-12-02",
        "is_current":true,
        "eu_decision_type":{
          "name":"i)",
          "description":"no significant trade anticipated",
          "type":"NO_OPINION"
        },
        "geo_entity":{
          "iso_code2":"ET",
          "name":"Ethiopia",
          "type":"COUNTRY"
        },
        "start_event":{
          "name":"No 338/97",
          "date":"1997-06-01",
          "url":"http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CONSLEG:1997R0338:20080411:EN:PDF"
        },
        "source":{
          "code":null,
          "name":null
        },
        "term":{
          "code":null,
          "name":null
        }
      },
      {
        "taxon_concept_id":4521,
        "notes":"Hunting trophies",
        "start_date":"2014-09-04",
        "is_current":true,
        "eu_decision_type":{
          "name":"Suspension (a)",
          "description":null,
          "type":"SUSPENSION"
        },
        "geo_entity":{
          "iso_code2":"CM",
          "name":"Cameroon",
          "type":"COUNTRY"
        },
        "start_event":{
          "name":"No 888/2014",
          "date":"2014-09-04",
          "url":"http://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32014R0888&from=EN"
        },
        "source":{
          "code":"W",
          "name":"Wild"
        },
        "term":{
          "code":null,
          "name":null
        }
      }
    ]
  }

<?xml version="1.0" encoding="UTF-8"?>
<eu-legislation>
  <eu-listings type="array">
    <eu-listing>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <is-current type="boolean">true</is-current>
      <annex>B</annex>
      <change-type>+</change-type>
      <effective-at type="date">2013-08-10</effective-at>
      <annotation>Populations of Botswana, Namibia, South Africa and Zimbabwe (listed in Annex B):

For the exclusive purpose of allowing: [...]</annotation>
    </eu-listing>
    <eu-listing>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <is-current type="boolean">true</is-current>
      <annex>A</annex>
      <change-type>+</change-type>
      <effective-at type="date">2013-08-10</effective-at>
      <annotation>All populations except those of Botswana, Namibia, South Africa and Zimbabwe.</annotation>
    </eu-listing>
  </eu-listings>
  <eu-decisions type="array">
    <eu-decision>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <notes></notes>
      <start-date type="date">2014-09-03</start-date>
      <is-current type="boolean">true</is-current>
      <eu-decision-type>
        <name>Positive</name>
        <description nil="true"/>
        <type>POSITIVE_OPINION</type>
      </eu-decision-type>
      <geo-entity>
        <iso-code2>BW</iso-code2>
        <name>Botswana</name>
        <type>COUNTRY</type>
      </geo-entity>
      <start-event>
        <name>No 338/97</name>
        <date>1997-06-01</date>
        <url>http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CONSLEG:1997R0338:20080411:EN:PDF</url>
      </start-event>
      <source>
        <code>W</code>
        <name>Wild</name>
      </source>
      <term>
        <code nil="true"/>
        <name nil="true"/>
      </term>
    </eu-decision>
    <eu-decision>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <notes nil="true"/>
      <start-date type="date">2011-12-02</start-date>
      <is-current type="boolean">true</is-current>
      <eu-decision-type>
        <name>i)</name>
        <description>no significant trade anticipated</description>
        <type>NO_OPINION</type>
      </eu-decision-type>
      <geo-entity>
        <iso-code2>ET</iso-code2>
        <name>Ethiopia</name>
        <type>COUNTRY</type>
      </geo-entity>
      <start-event>
        <name>No 338/97</name>
        <date>1997-06-01</date>
        <url>http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CONSLEG:1997R0338:20080411:EN:PDF</url>
      </start-event>
      <source>
        <code nil="true"/>
        <name nil="true"/>
      </source>
      <term>
        <code nil="true"/>
        <name nil="true"/>
      </term>
    </eu-decision>
    <eu-decision>
      <taxon-concept-id type="integer">4521</taxon-concept-id>
      <notes>Hunting trophies</notes>
      <start-date type="date">2014-09-04</start-date>
      <is-current type="boolean">true</is-current>
      <eu-decision-type>
        <name>Suspension (a)</name>
        <description nil="true"/>
        <type>SUSPENSION</type>
      </eu-decision-type>
      <geo-entity>
        <iso-code2>CM</iso-code2>
        <name>Cameroon</name>
        <type>COUNTRY</type>
      </geo-entity>
      <start-event>
        <name>No 888/2014</name>
        <date>2014-09-04</date>
        <url>http://eur-lex.europa.eu/legal-content/EN/TXT/PDF/?uri=CELEX:32014R0888&amp;from=EN</url>
      </start-event>
      <source>
        <code>W</code>
        <name>Wild</name>
      </source>
      <term>
        <code nil="true"/>
        <name nil="true"/>
      </term>
    </eu-decision>
  </eu-decisions>
</eu-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

Feedback

Supported Formats

GET api/v1/taxon_concepts/:taxon_concept_id/eu_legislation

eu_listings¶ ↑

eu_decisions¶ ↑

geo_entity¶ ↑

trade_code¶ ↑

event¶ ↑

annotation¶ ↑

eu_decision_type¶ ↑

Supported Formats

Errors

Examples

Params