List requests

Every request of the last 30 days, newest first, with its status, time and cost. Filter by status class, route, key or time, or find one request by its id. A key without full access sees only its own requests. Free.

GET /v1/requests

List requests

cURL

curl --request GET \
  --url https://api.outbound.dev/v1/requests \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "req_6a1f0c2b9d4e8a7f3c5b2e10",
      "createdAt": "2026-11-14T10:02:11.000Z",
      "method": "POST",
      "endpoint": "/v1/people/search",
      "product": "search",
      "statusCode": 200,
      "latencyMs": 5302,
      "units": 5,
      "costUsd": "0.000500",
      "apiKey": {
        "id": "6a1f0c2b9d4e8a7f3c5b2e11",
        "name": "Agent key",
        "prefix": "ob_live_7Kx2",
        "lastFour": "34hx"
      },
      "isReplay": false,
      "isMiss": false,
      "isHeld": false
    }
  ],
  "pagination": {
    "pageSize": 50,
    "nextCursor": "eyJ0IjoiMjAyNi0xMS0xNFQxMDowMjoxMS4wMDBaIn0"
  }
}

Authorizations

Authorization · string · header · required

An API key from the console, starting ob_live_, sent as Authorization: Bearer <key>.

Query Parameters

statusClass · enum<string>

Only requests answered with a status in this class.

Available options: 2xx, 4xx, 5xx

endpoint · string

Only requests to this route, as the requests name it.

Required string length: 1 - 200

apiKeyId · string

Only this key's requests. A key without full access reads only its own.

Required string length: 24

Pattern: ^[0-9a-fA-F]+$

from · string<date-time>

Only requests made at or after this time, in ISO 8601.

to · string<date-time>

Only requests made before this time, in ISO 8601.

q · string

A request id, matched exactly.

Required string length: 1 - 255

cursor · string

The nextCursor of the page before.

Maximum string length: 200

Pattern: ^[A-Za-z0-9_-]+$

pageSize · integer · default: 50

Requests per page.

Required range: 1 <= x <= 100

Response

200

application/json

One page of requests, newest first.

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes