Skip to main content

Account & Quota

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​

[
  "health_tips",
  "breed_facts",
  "image_labelling"
]

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
  }
]