---
title: "Search the photo checklist without saved animals."
method: POST
path: "/animals"
tags: ["Catalogue"]
---

# Search the photo checklist without saved animals.

`POST /animals`

## Request

- Base URL: `https://animalchecklist.com/api/v1`
- URL: `https://animalchecklist.com/api/v1/animals`
- Auth: none required

Same-origin only. Apply the GET filters before paging. Exclude up to 2,000 saved animal IDs. The response is not cached.

## Query parameters

- `q` string
- `category` string
- `habitat` string
- `country` string
- `sort` 'obs' | 'name'
- `page` integer
- `per` integer
- `lang` 'en' | 'de' | 'es' | 'fr' | 'it' | 'nl' | 'pt' | 'pl': Display language of `name`, category labels and the summary. Falls back to `en`.

## Request body

- object
  - `excludeIds` string[], required

## Response `200`

Filtered photo checklist. No-store.

- object
  - `data` object, required
    - `items` AnimalSummary[], required
      - `id` string, required: Slug of the animal taxon, for example `red-fox`.
      - `name` string, required: Name in the requested language, English when none exists.
      - `nameEn` string, required: English common name.
      - `nameSci` string, required: Scientific name.
      - `taxonRank` string: Taxonomic rank. Legacy records default to species.
      - `parentNameSci` string, nullable: Parent species scientific name for a subspecies. Null for species.
      - `categoryId` 'mammals' | 'birds' | 'reptiles' | 'amphibians' | 'fish' | 'insects' | 'other', required
      - `habitats` string[], required
      - `tickable` boolean: Whether a new checklist sighting is allowed.
      - `sourceUrl` string, uri
      - `image` object, nullable, required
        - `url` string, uri, required
    - `total` integer, required
    - `page` integer, required
    - `per` integer, required
    - `byDescription` boolean

## Other responses

- `400`: Invalid input.
- `404`: Not found.
- `429`: Rate limited.
- `500`: Unexpected error.

---

[API](https://skmtc.dev/animalchecklist/apis/animal-checklist-api.md) · [All operations](https://skmtc.dev/animalchecklist/apis/animal-checklist-api/llms.txt) · [OpenAPI document](https://skmtc.dev/animalchecklist/apis/animal-checklist-api/revisions/0910760ad25b?raw)