search_timeout

HTTP 503search_timeoutSearch timed out

The search exceeded its time limit (300 ms) and was cancelled.

Common causes

• a very broad query with many hits
• a short-lived server load spike

What to do

• Narrow the query (more words, the city, postal_code, type filters) and retry.
• For known identifiers use an exact lookup, which is always fast.

Retry?	Yes, with exponential backoff (honour Retry-After).
Billing	0 units.
type	https://maticna.si/docs/errors/search_timeout

Example response

HTTP/1.1 503
Content-Type: application/problem+json
Retry-After: <seconds>
X-Request-Id: req_01JB2Q8X6S7T

{
  "type": "https://maticna.si/docs/errors/search_timeout",
  "title": "Search timed out",
  "status": 503,
  "detail": "The search exceeded its time limit (300 ms) and was cancelled.",
  "instance": "/v1/entities/12345679",
  "code": "search_timeout",
  "request_id": "req_01JB2Q8X6S7T"
}

Other errors with status 503

• upstream_stale · Data temporarily stale

All errors