watchlist_unavailable (503)
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"
}
}