Errors & status codes

Standard HTTP semantics. Error responses are JSON in Spring's ProblemDetail shape.

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

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Provide at least one of listingIds or propertyIds"
}

Forbidden — no channel mapped

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "No channel mapped to authenticated partner prt_abc..."
}