Skip to main content

Account & Quota

See the guide

To see and switch off analysis capabilities, see Choose what's switched on.

Manage your account usage and features.

Check Quota​

Monitor your API usage to ensure you stay within your plan's limits.

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/accounts/quota

Example Response​

{
  "quota": 25,
  "usage": 12,
  "remaining": 13
}

Check Features​

List the features enabled for your account (e.g., enterprise endpoints).

curl -H "x-api-key: YOUR-API-KEY" https://api.thecatapi.com/v1/accounts/features

Example Response​

["full_breed_schema", "enable_health_tips", "exercise_by_lifestage", "clinical_history"]

To switch analysis endpoints off for your account, see Choose what's switched on.

List your sub IDs​

If you pass a sub_id when uploading images, voting, favouriting or creating pets, this endpoint summarises activity per sub ID so you can see what each of your users has done.

curl -H "x-api-key: YOUR-API-KEY" "https://api.thecatapi.com/v1/sub-ids?limit=100&page=0"

Example Response​

[
  {
    "sub_id": "my-user-123",
    "images": 4,
    "votes": 12,
    "favourites": 3,
    "pets": 1
  }
]