Skip to main content
GET
curl
Didit’s List Transactions endpoint reads an account’s transactions for a date range, booked and pending, with page-token pagination. Amounts are decimal strings and fields a bank does not send are null. To keep a copy in step, use the change feed instead of re-reading ranges.

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

account_id
string<uuid>
required

The account id.

Query Parameters

date_from
string<date>

First effective date to include, inclusive.

date_to
string<date>

Last effective date to include, inclusive. No upper bound when you leave it out.

status
enum<string>

Only booked or only pending transactions. Default both.

Available options:
booked,
pending
limit
integer
default:100

Page size, 1 to 500. Default 100.

Required range: 1 <= x <= 500
page_token
string

The next_page_token of the previous page.

Response

A page of transactions.

A page of a date-range read. The first page pins which transactions are included and each is served in its current state; a transaction removed while you page drops out of later pages and is reported by the change feed.

items
object[]
required

Sorted by effective_date descending, then id.

next_page_token
string | null
required

Continues this read. Pins the snapshot of the first page, lives one hour and is bound to the application, environment, account and filters of the read.

has_more
boolean
required
Last modified on November 22, 2026