> ## Documentation Index
> Fetch the complete documentation index at: https://docs.permitcore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Query timed out

> 504 — The query exceeded the server-side statement timeout.

The query exceeded the server-side statement timeout.

```json 504 application/problem+json theme={null}
{
  "type": "https://docs.permitcore.io/errors/query-timeout",
  "title": "Query timed out",
  "status": 504,
  "detail": "…",
  "instance": "/v1/permits",
  "request_id": "req_1f07fb45782b445e9f6312ba23921234"
}
```

Every PermitCore error is [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)
`application/problem+json`. **Branch on `type` (a stable URI)**, not on `title`
or `detail` (human-readable, may change).

## When it occurs

The query was too broad to finish inside the server-side statement-timeout cap. This protects the shared connection pool — it is the cap working, not an outage.

## How to fix

Narrow the filters (`jurisdiction`, date range, `target_segment`, `bbox`) and retry. A narrower query returns well within the timeout.

**Retryable** — retry with exponential backoff (respect `Retry-After` on `429`/`503`).

See the full [error catalog](/errors) for the response shape and retry matrix.
Every response carries an `x-request-id` header — include it in any support request.