API reference · Receipts

List deliveries

GET/v1/deliveries

Every fact the feed delivered to your account, on which channel and when, newest first.

On this page

Auth. An API token: Authorization: Bearer lb_… (create one). Signed-in web sessions work too.

Limits. Counts against your plan's API requests (60, 600 or 3,000 a minute on Free, Builder and Standard).

Parameters

Query parameters

Name	Type	Required	Description
`limit`	integer	no	Page size. 1 to 1000. Default `100`.
`before`	integer	no	`next_before` from the previous page.
`event_id`	string	no	One event (`ev_…`).
`evt_id`	string	no	One fact (`evt_…`).
`market`	string	no	Rows delivered for this market ticker.

Request

Terminal

curl "https://api.langbot.ai/v1/deliveries?limit=1" \
  -H "Authorization: Bearer $LANGBOT_API_TOKEN"

Python

import os

import httpx

r = httpx.get(
    "https://api.langbot.ai/v1/deliveries?limit=1",
    headers={"Authorization": f"Bearer {os.environ['LANGBOT_API_TOKEN']}"},
)
print(r.json())

TypeScript

const res = await fetch("https://api.langbot.ai/v1/deliveries?limit=1", {
  headers: { Authorization: `Bearer ${process.env.LANGBOT_API_TOKEN}` },
});
console.log(await res.json());

Response

200 OK

JSON

{
  "count": 1,
  "deliveries": [
    { "id": 902114, "evt_id": "evt_01J9ABCDEFGHJKMNPQRSTVWXYZ", "event_id": "ev_nvda_q3_2026", "channel": "socket", "t_delivered": 1760050133600, "t_spoken": 1760050123412, "lead_ms": 10188, "type": "phrase_detected", "phrase": "blackwell", "market_refs": ["KXEARNINGSMENTIONNVDA-26OCT-BLACKWELL"], "hash": "5d0e05c3…", "chain_seq": 48213, "token_id": "tok_01J9…", "agent": null, "webhook": null, "attestation_id": null }
  ],
  "next_before": 902114
}

channel is socket, sse, mcp, webhook or dashboard. lead_ms is t_delivered − t_spoken. Rows carry phrase facts only, never the surrounding text.

Errors

Status	`code`	When
401	`auth_required`	No token was sent.
401	`token_invalid`	The token was not recognised (mistyped, revoked or expired).
422	`validation_error`	A parameter failed validation; `detail[].loc` names it.
429	`rate_limited`	Over your request budget; wait `Retry-After` seconds.

Every error body is {"detail": …, "code": "…"}; branch on code. All codes: Errors.