Errors

All errors return a JSON body with code and message fields:

{
  "code": "INVALID_SIGNATURE",
  "message": "Request signature did not match expected value"
}

Common error codes

HTTP	Code	Meaning
400	INVALID_PARAMETER	A request parameter is missing or malformed
401	INVALID_SIGNATURE	Signature validation failed
401	KEY_EXPIRED	API key is no longer active
403	INSUFFICIENT_PERMISSION	Key lacks the required permission scope
429	RATE_LIMITED	Per-key rate limit exceeded
500	INTERNAL_ERROR	Unexpected server error — safe to retry