Skip to main content
GET
curl
Didit’s Travel Rule delivery history API returns every delivery entry for a transaction, paginated oldest first. Use your x-api-key with transaction read permission. transaction_id is the Didit transaction UUID. A missing transaction or transfer returns 404; insufficient permission returns 403.

Pagination and ordering

The response contains count, next, previous, and results. limit defaults to 100 and is capped at 100; offset defaults to zero and must not exceed 1,000,000, which returns 400. count is normally capped at 100 and is not a reliable total for larger histories. Follow next until it is null, regardless of count. Entries are ordered by creation time, then identifier for ties. Each entry has uuid, kind, status, rail, created_at, delivered_at, and detail_lines. rail is EMAIL, TRP, INTERNAL, NETWORK, or null before selection. detail_lines describes the message kind and status without raw errors or transport payloads.

Embedded history

Transaction detail includes only the newest 100 entries in travel_rule.deliveries, presented oldest first. deliveries_truncated tells you whether older entries were omitted. Transaction lists omit these two history fields. The existing delivery field continues to describe the newest delivery. See delivery and retries for status meanings. Counterparty messages are a separate conversation endpoint.

Authorizations

x-api-key
string
header
required

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Path Parameters

transaction_id
string<uuid>
required

Didit-stable transaction UUID that owns the transfer.

Query Parameters

limit
integer
default:100

Entries per page. Defaults to 100 and larger values are capped at 100; a value above 1,000,000 returns 400.

Required range: 1 <= x <= 1000000
offset
integer
default:0

Number of entries to skip, up to 1,000,000. A larger value returns 400.

Required range: 0 <= x <= 1000000

Response

Paginated delivery history, oldest first.

count
integer
required

Count normally capped at 100; it is not a reliable total for larger histories. Follow next until null, regardless of count.

Required range: x >= 0
next
string<uri> | null
required

Next page URL, or null.

previous
string<uri> | null
required

Previous page URL, or null.

results
object[]
required

Entries ordered oldest first by creation time, then identifier.

Last modified on November 11, 2026