TheCatAPI has a new home for its documentation at docs.thecatapi.com. The old developer portal at developers.thecatapi.com was written for the original cat service and had fallen behind the platform, so it now redirects here.

Under the hood TheCatAPI and TheDogAPI run on the same codebase, which we call the Animal API. That means every feature that landed on the dog side over the last year is available for cats too, with the same request shapes and the same x-api-key header. These docs are generated from the same source as docs.thedogapi.com, with the cat-specific examples swapped in, so the two sites will stay in step from now on.

What's covered​

• Images: search over 60,000 cat images, filter by breed or category, and manage your own uploads.
• Image uploads: asynchronous upload with status polling, or the synchronous endpoint on upload.thecatapi.com that returns the analysis in one call.
• Breeds: 100+ breeds with the full schema (coat group, 1–5 trait scores, hypoallergenic and rex flags, VeNom codes) and translations via ?lang=.
• Facts and Health tips: curated, localised content per breed with sources.
• Pets & Pet Analysis: pet profiles, body and muscle condition scores, estimated age and weight, breed mix, and AI portraits.
• WebSocket gateway: live votes and favourites as they happen.
• API Reference: the full OpenAPI spec served straight from api.thecatapi.com/openapi-json.

A few things to note when migrating​

Cat breed IDs are the same four-letter codes you already know (abys, beng, siam), and image IDs are unchanged, so existing integrations keep working. Breed objects now carry more fields than before; if you are mapping responses into your own types, treat unknown keys as optional.

The /breeds/{id}/facts path from the old docs does not exist on the new platform. Use /facts/breed/{id} or /facts?breed_id= instead. Votes can no longer be deleted; post a new vote with the opposite value.

If anything is missing or wrong, the edit link at the bottom of every page opens a pull request against the docs repo, or come and tell us on Discord.