API Reference

Errors

The API uses standard HTTP status codes and returns errors in a consistent JSON format.

Status codes

200Success

201Created

400Bad Request

401Unauthorized

403Forbidden (missing scope)

404Not Found

409Conflict (idempotency mismatch)

422Validation Error

429Rate Limited

500Internal Error

Error shape

All error responses share the same JSON structure with a top-level error object containing a machine-readable code and a human-readable message.

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Event not found"
  }
}

Common errors

Invalid API key `(401)`

Check that your key is active and the Bearer prefix is included in the Authorization header.

Missing scope `(403)`

Your key doesn't have the required scope for this endpoint. Check the endpoint documentation for the required scope and update your key in the manage portal.

Rate limited `(429)`

Wait for the retryAfter timestamp, then retry. See the Rate Limits page for details on tier allowances.