Skip to content

watchlist_unavailable (503)

← Error reference

watchlist_unavailable

HTTP status: 503

Retryable: Yes. The request did not change server state.

The watchlist search service is temporarily unavailable.

When it fires

The watchlist search API could not reach its screening backend, or the backend returned an internal failure. The search was not billed and no match result was served.

How to handle it

Retry with exponential backoff. If you sent an Idempotency-Key, send a NEW one on the retry: a byte-identical retry with the same key replays this 503 for 24 hours. Persistent occurrences are an internal incident; contact support with the request_id from the response.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/watchlist_unavailable",
    "code": "watchlist_unavailable",
    "message": "The watchlist search service is temporarily unavailable. Retry shortly.",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/watchlist_unavailable"
  }
}