> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Query timeout

The metrics query took too long to complete.

---

## Example

```json
{
  "error": {
    "type": "api_error",
    "code": "query_timeout",
    "detail": "The metrics query timed out. Try narrowing your date range or filters.",
    "documentation_url": "https://developer.paddle.com/errors/metrics/query_timeout"
  },
  "meta": {
    "request_id": "00000000-0000-0000-0000-000000000000"
  }
}
```

## Details

| Attribute | Value |
| --- | --- |
| Status code | 504 |
| Error code | `query_timeout` |
| Error message | The metrics query timed out. Try narrowing your date range or filters. |

## Common causes

- The query scanned too much data to complete within the time limit.

## Common solutions

- Narrow the date range between `from` and `to`.
- Add filters or reduce the number of dimensions to lower the amount of data scanned.
- Wait a few moments and retry the request.
- If the query keeps timing out, contact the [Paddle support team](mailto:sellers@paddle.com). Include the `request_id` with your message.