Errors and limits

How errors are returned

Most failures return JSON {"detail":"..."} with an HTTP status. Keep X-Request-ID for support.

400 Bad Request

Invalid or inconsistent dates (format, From > To, range over one month)

Unknown query parameter

page and pageSize are not allowed with Parquet downloads

Invalid appId / Invalid role / Invalid app configuration. Contact support.

401 Unauthorized

Missing or invalid API key

Invalid or expired access token

Subscription key missing or invalid

403 Forbidden

Insufficient permissions for the requested resource or datapoints

Incomplete application / client configuration

404 Not Found

Endpoint not found. Check the URL and try again.

406 Not Acceptable

Unsupported Accept header.

413 Payload Too Large

Response exceeds the size limit. Apply additional filters to reduce the result set.

422 Unprocessable Entity

pageSize or page out of allowed range

Unknown or disallowed field in the request

429 Too Many Requests

Throttled by APIM. Respect Retry-After and X-RateLimit-* headers.

500 / 503

Unexpected server error, or dependency unavailable (for example role config / data store). Retry later or contact support with X-Request-ID.

Practical limits

Date window: maximum one month per request

Parquet/zip responses are capped; tighten filters on 413

Never put live tokens or keys in tickets, screenshots, or shared docs