Loading...
Animal Detect logo

API endpoint update

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

Countries

Free reference endpoint
GET /v1/countries

List countries supported by country-based detection and filtering options.

Try in Playground

Examples

Node.js / Express
const response = await fetch(
  'https://api.animaldetect.com/v1/countries?region=Europe',
  {
    headers: {
      Authorization: 'Bearer ' + process.env.ANIMAL_DETECT_API_KEY,
    },
  }
)

const data = await response.json()
Example Response
{
  "countries": [
    {
      "name": "France",
      "cca2": "FR",
      "cca3": "FRA",
      "region": "Europe"
    }
  ],
  "total": 1
}

Parameters

Optional

string

Search by country name, CCA2, or CCA3.

Americas | Europe | Africa | Asia | Oceania | Antarctic

Filter countries by region.

Status Codes

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