Documentation Index
Fetch the complete documentation index at: https://docs.docketlayer.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
GET /v2/wallet/deliveries returns a paginated list of callback delivery records for your wallet address. Use it to monitor delivery health, investigate failures, and audit which cases triggered callbacks.
Base URL: https://api.docketlayer.ai
Price: $0.99 per call
Request
Parameters
| Field | Type | Required | Description |
|---|
limit | number | No | Records to return. Min: 1, max: 200. Default: 50. |
cursor | string | No | Pagination cursor from next_cursor in a prior response. |
status | string | No | Filter by delivery status: succeeded, failed, or retrying. |
since | string | No | ISO-8601 timestamp — return only deliveries with last_attempt_at after this time. |
Example request
curl "https://api.docketlayer.ai/v2/wallet/deliveries?limit=25&status=failed"
# x402 payment required — use your x402 client library
Response
{
"meta": {
"request_id": "req_01jt7y4kx0",
"queried_at": "2026-04-29T12:00:00Z",
"query_cost_usd": 0.99,
"sandbox": false
},
"wallet": "YourSolanaPublicKey...",
"deliveries": [
{
"delivery_id": "del_abc123",
"case_id": "1:24-cv-01234",
"court_code": "nysd",
"callback_url": "https://yourapp.com/webhooks/docketlayer",
"status": "succeeded",
"attempts": 1,
"first_attempt_at": "2026-04-29T10:00:00Z",
"last_attempt_at": "2026-04-29T10:00:03Z",
"last_response_code": 200,
"idempotency_key": "idem_xyz789"
}
],
"next_cursor": null
}
Delivery object fields
| Field | Type | Description |
|---|
delivery_id | string | Unique delivery identifier |
case_id | string | null | Case that triggered this delivery |
court_code | string | null | Court of the triggering case |
callback_url | string | The URL DocketLayer posted to |
status | string | succeeded, failed, or retrying |
attempts | number | Total delivery attempts made |
first_attempt_at | string | ISO-8601 timestamp of first attempt |
last_attempt_at | string | ISO-8601 timestamp of most recent attempt |
last_response_code | number | null | HTTP status code from your endpoint’s last response |
idempotency_key | string | Stable key for deduplication — present on all retry attempts |
Delivery status values
| Status | Meaning |
|---|
retrying | Delivery has failed at least once and will be retried |
succeeded | Your endpoint returned 2xx |
failed | Maximum retry attempts exhausted without a 2xx response |
Retry schedule
DocketLayer retries failed deliveries up to 7 times with exponential backoff:
| Attempt | Delay after previous |
|---|
| 2 | 3 minutes |
| 3 | 9 minutes |
| 4 | 27 minutes |
| 5 | ~1.4 hours |
| 6 | ~4 hours |
| 7 | ~12 hours |
failed and no further attempts are made.
When there are more results than limit, the response includes next_cursor. Pass it as cursor in your next request to retrieve the next page.
cursor = None
while True:
params = {"limit": 50}
if cursor:
params["cursor"] = cursor
page = client.get(
"https://api.docketlayer.ai/v2/wallet/deliveries",
params=params
).json()
process(page["deliveries"])
cursor = page.get("next_cursor")
if not cursor:
break
