Our API uses standard HTTP status codes to indicate the success or failure of API requests.

​
Client Errors (4XX)

These errors are typically caused by issues in your request and can usually be resolved by modifying the request.
  • 400 - Bad Request: The request was malformed or contains invalid syntax. Check that all required fields are present and that parameter values are correctly formatted.
  • 401 - Unauthorized: Authentication failed. Your access token may be invalid, expired, or missing. Verify your authentication credentials and ensure you’re including the Bearer token in the Authorization header.
  • 403 - Forbidden: You don’t have permission to access the requested resource or perform this action. This may indicate insufficient privileges for your account.
  • 404 - Not Found: The requested resource could not be found. Verify the endpoint URL and any resource IDs in your request.
  • 413 - Payload Too Large: The request payload exceeds the maximum allowed size. Check the endpoint documentation for size limits, particularly for file uploads.
  • 415 - Unsupported Media Type: The request content type is not supported. Verify that you’re using the correct Content-Type header and file format as specified in the endpoint documentation.
  • 422 - Unprocessable Entity: The request is well-formed but contains semantic errors or validation failures. This typically occurs with invalid data formats, out-of-range values, or business rule violations.

​
Server Errors (5XX)

These errors indicate problems on our server side and are typically temporary.
  • 500 - Internal Server Error: An unexpected error occurred on our servers. Please contact support if you see this.