Error Codes

All API errors return the following structure:

{
  "status": false,
  "message": "Human-readable message",
  "error_code": "MACHINE_READABLE_CODE"
}

HTTP Status	error_code	Meaning
400	INVALID_PARAM	A request parameter is missing or invalid (e.g. bad date format, non-numeric ID)
401	MISSING_TOKEN	No Authorization header or not a Bearer token
401	INVALID_TOKEN	Token is expired, malformed, or signature is invalid
403	INSUFFICIENT_SCOPE	Token is valid but has no network_ids assigned
403	FORBIDDEN_NETWORKS	Authenticated but the requested resource is not in your authorized networks
404	NOT_FOUND	The requested resource does not exist or is not visible to your credentials
500	SERVER_ERROR	Internal server error - contact support if this persists
503	SERVICE_UNAVAILABLE	Auth service (JWKS endpoint) is temporarily unreachable - retry with backoff

Retry strategy

For 503 SERVICE_UNAVAILABLE, retry with exponential backoff.