TRACE_LIST_FAILED

Cause

Either the repository refused the filters (a date range wider than the cap, a cursor issued for a different query, a missing partition filter) or the query itself faulted. The repository reason is carried in the message.

How to fix it

Narrow the date range, drop the cursor and start from the first page, or retry with backoff.

Example response

{
  "error_code": "TRACE_LIST_FAILED",
  "error_type": "api_error",
  "error_message": "The trace list or recent-feed query was rejected.",
  "hint": "Narrow the date range, drop the cursor and start from the first page, or retry with backoff.",
  "docs_url": "https://docs.billerapi.com/errors/TRACE_LIST_FAILED",
  "request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}

Related

• Error handling — the error envelope shape and how to parse it
• Error code reference — every stable error code