# Request history: `GET /v1/requests`

Cost: free (0 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/requests

Newest-first metadata with keyset pagination and optional filters.

Parameters:

- `limit` (integer; optional; default 50; min 1, max 200)
- `cursor` (string | null; optional): Opaque `next_cursor` from the previous page.
- `status` (integer | null; optional; min 100, max 599)
- `method` (string | null; optional; pattern ^(GET|POST|PUT|PATCH|DELETE)$)
- `path` (string | null; optional; max length 300): Exact normalized route path, such as `/v1/calendar`.

Response fields:

- `requests` (array of object; required): Newest first.
  - `requests[].id` (string; required): `req_...`; equals the `x-request-id` response header.
  - `requests[].method` (string; required)
  - `requests[].path` (string; required): Route path, e.g. `/v1/calendar`.
  - `requests[].status` (integer; required)
  - `requests[].duration_ms` (integer; required)
  - `requests[].response_bytes` (integer; required)
  - `requests[].request` (object; required): Sanitized request metadata; each key present only when the request had it.
  - `requests[].created_at` (string; required): Timestamp string, e.g. `2026-08-10 14:05:00.123456+00`.
- `count` (integer; required)
- `has_more` (boolean; required)
- `next_cursor` (string; optional): Present only when `has_more` is true; pass it back as the `cursor` query parameter.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
