Get a request

One request of the last 30 days with its request and response bodies, as JSON text with keys and passwords removed. A key without full access reads only its own requests; another key’s request answers 404. Free.

GET /v1/requests/{requestId}

Get a request

cURL

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

200

{
  "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,
  "ip": "203.0.113.24",
  "requestBody": "{\"query\":\"operations directors at logistics companies in Portugal\",\"limit\":5}",
  "responseBody": "{\"data\":[...],\"pagination\":{\"nextCursor\":\"...\"}}",
  "balanceAfterUsd": "9.998200"
}

Authorizations

Authorization · string · header · required

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

Path Parameters

requestId · string · required

The request's id, as its X-Request-Id header and the requests list give it.

Maximum string length: 100

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

Response

200

application/json

The request, with its bodies.

id · string

The request's id, as its X-Request-Id header gave it.

createdAt · string<date-time>

method · string

endpoint · string

The route called, such as /v1/people/search.

product · enum<string>

Available options: search, enrichment, lists, campaigns, connections, account

statusCode · integer

latencyMs · integer

units · integer

What the call was billed for: 0 on a miss. Absent for a call that bills nothing.

costUsd · string

What the call cost, in US dollars.

apiKey · object

The key that made the call. Its name and masked form are absent when the key no longer exists.

Show child attributes

isReplay · boolean

Whether the answer was an earlier request's, replayed.

isMiss · boolean

The call succeeded but found nothing, so it cost nothing.

isHeld · boolean

Money is still set aside for it: the call is running or its charge is not final yet.

ip · string

The address the call came from.

idempotencyKey · string

The idempotency key the call carried, if any.

requestBody · string

The request body as JSON text, at most 16 KB, with keys and passwords removed.

responseBody · string

The answer's body as JSON text, at most 16 KB.

balanceAfterUsd · string

The balance after the call's charge, for a charged call.