Reference

Error Codes

All API errors follow a consistent JSON structure. The error field contains a human-readable message.

JSON
// Standard error response format
{ "error": "Description of what went wrong" }

HTTP Status Codes

The request is malformed or missing required fields.

Reason: Missing required field

JSON
{ "error": "Missing provider in payload" }

Authentication failed. The API key is missing, malformed, or invalid.

Reason: No auth header

JSON
{ "error": "Missing or invalid Authorization header" }

Reason: Invalid key

JSON
{ "error": "Invalid API Key" }

The key authenticated, but lacks the scope (or plan) required for this endpoint.

Reason: Key missing the required scope

JSON
{ "error": "API key does not have the track:write scope" }

The requested resource does not exist.

Reason: Model not found

JSON
{ "error": "Not found" }

Rate limit exceeded on POST /v1/track. Back off and retry after the 1-minute window.

Reason: Too many track requests

JSON
{ "error": "Rate limit exceeded" }

An unexpected server-side error. If persistent, contact support.

Reason: Database error

JSON
{ "error": "Internal Server Error" }