Loading...
Animal Detect logo

API endpoint update

New integrations should use . Existing URLs will keep working for the next few months while teams migrate.

Country Species

Free endpoint
GET /v1/countries/{code}/species

List supported species for one country code.

Try in Playground

Examples

Node.js / Express
const response = await fetch(
  'https://api.animaldetect.com/v1/countries/USA/species?limit=25&offset=0',
  {
    headers: {
      Authorization: 'Bearer ' + process.env.ANIMAL_DETECT_API_KEY,
    },
  }
)

const data = await response.json()
Example Response
{
  "country": "USA",
  "species": [
    {
      "id": "3184697f-51ad-4608-9a28-9edb5500159c",
      "common_name": "fox",
      "scientific_name": "vulpes vulpes",
      "taxonomy": {
        "class": "mammalia",
        "order": "carnivora",
        "family": "canidae",
        "genus": "vulpes",
        "species": "vulpes"
      }
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 25,
    "offset": 0,
    "has_more": false
  }
}

Parameters

Required

CCA3

Country code (e.g., USA).

Optional

integer

Page size (1-100). Default: 50.

integer

Starting index. Default: 0.

Status Codes

200Country species list returned.
400Invalid query params.
401Invalid, missing, or revoked API key.
404Country code not supported.
429Rate limit exceeded.