Skip to main content
HTTP Status Codes:
StatusMeaning
200Success
400Bad request — missing or invalid parameters
401Unauthorized — missing or invalid API key
403Forbidden — key doesn’t have permission (e.g., pk_ key on sk_-only endpoint)
404Not found — resource doesn’t exist
429Rate limited — too many requests
500Internal server error
Error Response Format: 
{
  "error": "description of what went wrong"
}
Rate Limits:
  • Default: 10 requests/second per API key
  • Events endpoint (track): higher limit for batch ingestion
  • Rate limit headers are not currently returned (planned)
Common errors and fixes: “invalid api key” → Check your key prefix (pk_ vs sk_) and that it hasn’t been revoked “customer not found” → The external_customer_id doesn’t match any customer in your workspace “feature not found” → The feature key doesn’t match any entitlement on the customer’s plan “subscription not active” → Customer doesn’t have an active subscription “insufficient credits” → Credit balance too low for the operation