For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Paddle Docs home

Query timeout

The metrics query took too long to complete.

Example response
{
"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

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.

Troubleshooting

  • 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. Include the request_id with your message.

Was this page helpful?