Responses, errors, and rate limits

REST API response envelopes, HTTP errors, validation failures, rate limits, and retry guidance.

Successful controlled responses contain status: true; controlled errors contain status: false. Resource data is normally returned in data.

Status	Meaning
`200`	Request completed.
`201`	A customer, override, or promotional entitlement was created.
`401`	The API key is missing or invalid.
`403`	The key lacks the required ability.
`404`	The resource is outside the key's project or does not exist.
`422`	A path parameter, header, or JSON field is invalid.
`429`	A rate limit was exceeded.
`500`	An unexpected server error occurred.

Limits are 120 requests per minute per key, 300 per minute per key/IP pair, and 20,000 per day per key. Retry 429 and temporary 5xx failures with exponential backoff and jitter. Do not retry 401, 403, 404, or 422 without correcting the request.

{
  "status": false,
  "code": "API_KEY_ABILITY_DENIED",
  "message": "The API key does not have the required ability."
}

REST API authentication

Subscribers and attributes API

Responses, errors, and rate limits

Related guides