Search reports
GET/reports/search
Searches reports from the last year. Narrow the window with a date range in the
query, for example date:[2026-05-01 TO 2026-05-09]. Results are filtered by
visibility after matching, so page.total_hits counts matches before filtering and
a page can hold fewer than limit items. For the next page, add limit to
offset. Quota class report_search.
Request
Responses
- 200
- 400
- 401
- 403
- 429
- 500
- 502
- 503
- 504
One page of matching report overviews.
Response Headers
The minute, hour, and day limits of the governing quota, for example 50;w=60, 500;w=3600, 500;w=86400.
Limit of the governing window.
Requests remaining in the governing window.
Seconds until capacity is available in the governing window.
BAD_REQUEST: a parameter is missing or invalid, or a cursor was reused with different parameters.
MISSING_API_KEY: the x-apikey header is missing.
INVALID_API_KEY (the key is invalid or disabled, or could not be verified) or FORBIDDEN (the key may not use this operation).
RATE_LIMIT_EXCEEDED: a quota is exhausted. Wait Retry-After seconds. Rejected requests are not counted.
Response Headers
The minute, hour, and day limits of the governing quota, for example 50;w=60, 500;w=3600, 500;w=86400.
Limit of the governing window.
Requests remaining in the governing window.
Seconds until capacity is available in the governing window.
Seconds to wait before retrying.
INTERNAL_ERROR: an unexpected gateway failure. Retry later.
BAD_GATEWAY: an internal service failed or returned an invalid response. Retry later.
RATE_LIMIT_UNAVAILABLE: quota enforcement is temporarily unavailable. Retry later.
GATEWAY_TIMEOUT: an internal service timed out. Retry later.