GET /v2/wallet/deliveries

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

After 7 attempts with no 2xx response, the delivery moves to failed and no further attempts are made.

Pagination

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

Getting started

API reference

Concepts

Guides

Integration quickstarts

Resources

GET /v2/wallet/deliveries

Overview

Request

Parameters

Example request

Response

Delivery object fields

Delivery status values

Retry schedule

​Overview

​Request

​Parameters

​Example request

​Response

​Delivery object fields

​Delivery status values

​Retry schedule

​Pagination

Overview

Request

Parameters

Example request

Response

Delivery object fields

Delivery status values

Retry schedule

Pagination