# Request log (GET /v1/requests)

> GET /v1/requests: Request log. border.bot API reference (Account).

Source: https://border.bot/docs/api/list-api-requests

> Documentation index: https://border.bot/llms.txt. Every page is Markdown at its URL + `.md`.

`GET https://api.border.bot/v1/requests`

Requires an API key (`Authorization: Bearer bb_live_…`).

Every request your API keys made in the last 30 days, newest first: what it called, how it ended (status and error code), how long it took, and, for requests that change something, the body. Quote a request's `requestId` (its `X-Request-Id`) to support.

API key scope: `account`.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | no | Page size (1–100). |
| `cursor` | string | no | The `next` of the previous page. |
| `failed` | "true" \| "false" | no | `true`: only requests that failed (status 400 and up). |
| `requestId` | string | no | One request, by the `X-Request-Id` its response carried. |

## Responses

- `200`: A page of requests. (`ApiRequestsResponse`)
- `400`: Invalid input (`invalid_input`). (`Error`)
- `401`: Missing, invalid, revoked or expired API key (`unauthorized`). (`Error`)
- `403`: The API key doesn’t have the `account` scope (`forbidden`, `details.reason: "missing_scope"`). (`Error`)
- `429`: Rate limited (`rate_limited`). Retry after `Retry-After` seconds; `RateLimit` says which limit was hit (`r=0`, `t` seconds until its window ends) and `RateLimit-Policy` its quota. (`Error`)
- `500`: Unexpected error (`internal`). (`Error`)

## Example

```bash
curl -X GET 'https://api.border.bot/v1/requests' \
  -H 'Authorization: Bearer bb_live_...'
```