Limits #

We impose limits on our APIs to ensure fair usage and platform stability for all customers.

User-Agents #

Who are you?

For custom integrations, please set an explicit User-Agent header for all API calls, please follow the syntax as outlined on MDN.

Example:

curl -H 'User-Agent: my-tool/version; https://some.url' \
-H 'X-API-Key: ptr_....' \
https://console.planetary-quantum.com/api/users/me

Requests without a User-Agent are blocked.

Rate Limits #

API requests to /api/ endpoints are rate-limited per API key.

When the rate limit is exceeded, you’ll receive a 429 Too Many Requests response:

curl -i -H 'User-Agent: my-tool/1.0' \
-H 'X-API-Key: ptr_....' \
https://console.planetary-quantum.com/api/users/me

HTTP/2 429
x-ratelimit-limit: 150
retry-after: 5
content-type: application/json

{"message": "Rate limit exceeded. Please slow down.", "details": "https://docs.planetary-quantum.com/platform/limits/"}

The Retry-After header indicates when you can retry (in seconds).

Rate limits apply only to authenticated API requests (those with an X-API-Key header). Browser sessions using the console UI are not rate-limited.

Monitoring #

We ask you to not run additional monitoring checks on our infrastructure and instead to subscribe to our status page via email.