Quotas

GET https://api.synthetic.new/v2/quotas

Retrieve information about your API usage quotas and limits. blah

Tip

/quotas requests do not count against your subscription limits!

The Synthetic API is still under development.

If there is more data you would like to see and access, please let us know!

Example Request

Python
TypeScript
curl

import requests

headers = {
  "Authorization": "Bearer SYNTHETIC_API_KEY"
}

response = requests.get(
  "https://api.synthetic.new/v2/quotas",
  headers=headers
)

print(response.json())

Example Response

json

{
  "subscription": {
    "limit": 135,
    "requests": 0,
    "renewsAt": "2025-09-21T14:36:14.288Z"
  }
}

Helpful Alias

You can add this alias to your ~/.bashrc or ~/.zshrc to quickly get your quota information via synthetic_quota. (Thanks Jared for contributing!)

bash

alias synthetic_quota='curl -s https://api.synthetic.new/v2/quotas \
  -H "Authorization: Bearer ${SYNTHETIC_API_KEY}" \
  | jq --color-output .'