Errors

Truee errors are JSON responses with a stable shape.

{
  "success": false,
  "error": "Missing or invalid API key",
  "code": "UNAUTHORIZED",
  "timestamp": "2026-05-25T12:00:00.000Z"
}

Common errors

Status	Code	Meaning
400	VALIDATION_ERROR	Request body or query parameters are invalid.
401	UNAUTHORIZED	Missing, invalid, expired, or disabled API key.
403	FORBIDDEN	The API key is valid but not allowed for this action.
404	NOT_FOUND	The requested business or resource does not exist.
429	RATE_LIMITED	The account has reached a request or query quota.
500	INTERNAL_ERROR	Unexpected server failure. Retry with backoff.

Retry guidance

Retry 429 and 500 responses with exponential backoff. Do not retry validation or authentication failures until the request is corrected.