Skip to main content
GET
Retrieve a request log entry

Authorizations

Authorization
string
header
required

Your API key, sent as Authorization: Bearer <key>. Live and test keys are separate; the key you send decides which world the call acts in. To try calls, use a test key (it starts with lst_test_): no real courier is sent and no real money moves, but webhooks fire and the dropoff.phone you give can receive WhatsApp messages, so use your own number. A live key (it starts with lst_live_) books and charges real deliveries.

Path Parameters

id
string
required

The call's req_ id, from GET /v1/request_logs. A call that is not yours, or was made with a key of the other mode, is 404 not_found.

Response

200 - application/json

The request succeeded.

One call with what was sent and what came back. The bodies are the stored copy: an API key anywhere in them reads as its first characters and [key masked], the link in the answer to POST /v1/connect_requests or a Stripe onboarding call reads [redacted: one-time link], and a body over 64 KB is an object with _listo_truncated: true, its original_bytes and the first 64 KB as text. Headers are never kept.

id
string
required

The call's id, req_ prefixed.

Example:

"req_4f9c2b7e1a8d3056b1c2d3e4"

method
string
required

The HTTP method of the call.

Example:

"POST"

path
string | null
required

The path that was called, with its query string. Null on a call made before paths were kept.

Example:

"/v1/deliveries"

endpoint
string
required

Which operation the call reached, as controller#action.

Example:

"api/v1/deliveries#create"

status
integer
required

The HTTP status Listo answered with.

Example:

422

error_code
string | null
required

The error.code of the answer when it was an error, otherwise null.

Example:

"validation_failed"

duration_ms
integer | null
required

How long Listo took to answer, in milliseconds. Null when it was not measured.

Example:

118

request_id
string | null
required

The call's request id, the value of the X-Request-Id response header. Null on a call made before request ids were kept.

Example:

"0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"

api_key_prefix
string | null
required

The first characters of the key that made the call, never the secret. Null when no key is on record for the call.

Example:

"lst_test_Ab1"

test
boolean
required

True when the call was made with a test key.

created_at
string<date-time>
required

When Listo received the call, ISO-8601 in UTC.

Example:

"2026-11-06T16:02:11Z"

request_body
any
required

What the call sent, as JSON. Null when nothing was sent, on a call made before bodies were kept, and on the three debugging reads themselves, which keep no bodies.

response_body
any
required

What Listo answered, as JSON. Null on the same rows request_body is.