Errors & status codes

Standard HTTP semantics. Error responses are JSON with status, error, message, and path fields.

Code	Meaning
200	Success.
400	Bad request — missing required params, invalid date range, etc.
401	Missing or invalid API key.
403	Authenticated, but the partner isn't permitted (e.g. no channel mapped on /api/rates).
404	Resource not found.
429	Rate limited. Retry with exponential backoff.
5xx	Server error. Safe to retry idempotent calls (GET).

Examples

Missing auth header

HTTP/1.1 401 Unauthorized

Bad request

{
  "status": 400,
  "error": "Bad Request",
  "message": "Provide at least one of listingIds or propertyIds",
  "path": "/api/rates"
}

Forbidden

{
  "status": 403,
  "error": "Forbidden",
  "message": "API key is not authorized for rate access.",
  "path": "/api/rates"
}