API guide
Errors and limitsBranch on stable machine-readable error codes and use HTTP status codes for broad handling.
Error envelope
JSON
{
  "error": "scope_required",
  "message": "This endpoint requires traffic:read",
  "required_scope": "traffic:read"
}
The error value is stable. Human-readable message text can be improved without a version change.
Common errors
ParameterInTypeDescription
api_key_required401errorAuthorization header was not sent.
api_key_malformed401errorThe bearer value is not a valid AS213905 key.
api_key_invalid401errorKey is unknown, expired or revoked.
scope_required403errorKey does not hold the endpoint scope.
address_not_allowed403errorRequest source does not match the key allowlist.
not_found404errorResource does not exist in the key organisation.
conflict409errorResource limit or current state prevents the operation.
rate_limited429errorRetry after the number of seconds in Retry-After.
Retry policy
Retry only safe failures
Retry 429 and transient 5xx responses with exponential backoff and jitter. Respect Retry-After. Do not blindly retry validation errors or write operations that may already have been accepted.