curl 'https://verification.didit.me/v3/bank/accounts/a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10/transactions/?date_from=2026-01-01&date_to=2026-11-21&status=booked' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_transactions(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.listTransactions("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListTransactions(ctx, "11111111-2222-3333-4444-555555555555", didit.BankListTransactionsParams{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().listTransactions("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->listTransactions('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_transactions("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.ListTransactionsAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "e5b1f8a3-0d47-4c92-a6e0-7f3c2d9b1845",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "pending",
"pending_id": null,
"reverses_id": null,
"booking_date": null,
"value_date": null,
"transaction_date": "2026-11-21",
"effective_date": "2026-11-21",
"amount": "-64.90",
"currency": "EUR",
"direction": "debit",
"description": "PAGO TARJETA PAPELERIA CENTRAL",
"counterparty": {
"name": "PAPELERIA CENTRAL",
"iban": null,
"bic": null
},
"remittance": {
"unstructured": [],
"structured": null,
"reference": null
},
"bank_transaction_code": null,
"bank_reference": null,
"identity_quality": "derived",
"end_to_end_id": null,
"mandate_id": null,
"creditor_id": null,
"merchant_category_code": "5943",
"exchange": null,
"balance_after": null,
"category": "office_supplies",
"first_seen_at": "2026-11-21T12:04:40Z",
"updated_at": "2026-11-21T12:04:40Z"
},
{
"id": "8f2b6d41-9c3a-4e57-b0d8-1a7e5c4f2963",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "booked",
"pending_id": null,
"reverses_id": null,
"booking_date": "2026-11-19",
"value_date": "2026-11-20",
"transaction_date": null,
"effective_date": "2026-11-19",
"amount": "-1210.00",
"currency": "EUR",
"direction": "debit",
"description": "RECIBO SEGURIDAD SOCIAL",
"counterparty": {
"name": "ENTIDAD PUBLICA DE EJEMPLO",
"iban": "ES0000000000000000005766",
"bic": null
},
"remittance": {
"unstructured": [
"RECIBO SEGURIDAD SOCIAL 10/2026"
],
"structured": null,
"reference": "0028123456789"
},
"bank_transaction_code": "PMNT-RDDT-ESDD",
"bank_reference": "2026111900012345",
"identity_quality": "bank_reference",
"end_to_end_id": "NOTPROVIDED",
"mandate_id": "ES-SS-000123",
"creditor_id": "ES00ZZZ00000000",
"merchant_category_code": null,
"exchange": null,
"balance_after": "18250.34",
"category": "taxes_and_social_security",
"first_seen_at": "2026-11-20T06:00:12Z",
"updated_at": "2026-11-20T06:00:12Z"
},
{
"id": "2c9e7a05-6b14-4d38-8f2a-b3d51e0c9a67",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "booked",
"pending_id": null,
"reverses_id": null,
"booking_date": "2026-11-18",
"value_date": "2026-11-18",
"transaction_date": null,
"effective_date": "2026-11-18",
"amount": "3450.00",
"currency": "EUR",
"direction": "credit",
"description": "TRANSFERENCIA FACTURA 2026-0418",
"counterparty": {
"name": "CLIENTE DE EJEMPLO SL",
"iban": "ES0000000000000000007891",
"bic": null
},
"remittance": {
"unstructured": [
"FRA 2026-0418"
],
"structured": null,
"reference": null
},
"bank_transaction_code": "PMNT-RCDT-ESCT",
"bank_reference": "2026111800009876",
"identity_quality": "bank_reference",
"end_to_end_id": "2026-0418",
"mandate_id": null,
"creditor_id": null,
"merchant_category_code": null,
"exchange": null,
"balance_after": "19460.34",
"category": "income",
"first_seen_at": "2026-11-19T06:00:10Z",
"updated_at": "2026-11-19T06:00:10Z"
}
],
"next_page_token": null,
"has_more": false
}List Bank Transactions API: Date Range, Booked and Pending
Didit’s List Transactions endpoint reads an account’s transactions for a date range, booked and pending, with page-token pagination.
curl 'https://verification.didit.me/v3/bank/accounts/a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10/transactions/?date_from=2026-01-01&date_to=2026-11-21&status=booked' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.list_transactions(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.listTransactions("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.ListTransactions(ctx, "11111111-2222-3333-4444-555555555555", didit.BankListTransactionsParams{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().listTransactions("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->listTransactions('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.list_transactions("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.ListTransactionsAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"items": [
{
"id": "e5b1f8a3-0d47-4c92-a6e0-7f3c2d9b1845",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "pending",
"pending_id": null,
"reverses_id": null,
"booking_date": null,
"value_date": null,
"transaction_date": "2026-11-21",
"effective_date": "2026-11-21",
"amount": "-64.90",
"currency": "EUR",
"direction": "debit",
"description": "PAGO TARJETA PAPELERIA CENTRAL",
"counterparty": {
"name": "PAPELERIA CENTRAL",
"iban": null,
"bic": null
},
"remittance": {
"unstructured": [],
"structured": null,
"reference": null
},
"bank_transaction_code": null,
"bank_reference": null,
"identity_quality": "derived",
"end_to_end_id": null,
"mandate_id": null,
"creditor_id": null,
"merchant_category_code": "5943",
"exchange": null,
"balance_after": null,
"category": "office_supplies",
"first_seen_at": "2026-11-21T12:04:40Z",
"updated_at": "2026-11-21T12:04:40Z"
},
{
"id": "8f2b6d41-9c3a-4e57-b0d8-1a7e5c4f2963",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "booked",
"pending_id": null,
"reverses_id": null,
"booking_date": "2026-11-19",
"value_date": "2026-11-20",
"transaction_date": null,
"effective_date": "2026-11-19",
"amount": "-1210.00",
"currency": "EUR",
"direction": "debit",
"description": "RECIBO SEGURIDAD SOCIAL",
"counterparty": {
"name": "ENTIDAD PUBLICA DE EJEMPLO",
"iban": "ES0000000000000000005766",
"bic": null
},
"remittance": {
"unstructured": [
"RECIBO SEGURIDAD SOCIAL 10/2026"
],
"structured": null,
"reference": "0028123456789"
},
"bank_transaction_code": "PMNT-RDDT-ESDD",
"bank_reference": "2026111900012345",
"identity_quality": "bank_reference",
"end_to_end_id": "NOTPROVIDED",
"mandate_id": "ES-SS-000123",
"creditor_id": "ES00ZZZ00000000",
"merchant_category_code": null,
"exchange": null,
"balance_after": "18250.34",
"category": "taxes_and_social_security",
"first_seen_at": "2026-11-20T06:00:12Z",
"updated_at": "2026-11-20T06:00:12Z"
},
{
"id": "2c9e7a05-6b14-4d38-8f2a-b3d51e0c9a67",
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"status": "booked",
"pending_id": null,
"reverses_id": null,
"booking_date": "2026-11-18",
"value_date": "2026-11-18",
"transaction_date": null,
"effective_date": "2026-11-18",
"amount": "3450.00",
"currency": "EUR",
"direction": "credit",
"description": "TRANSFERENCIA FACTURA 2026-0418",
"counterparty": {
"name": "CLIENTE DE EJEMPLO SL",
"iban": "ES0000000000000000007891",
"bic": null
},
"remittance": {
"unstructured": [
"FRA 2026-0418"
],
"structured": null,
"reference": null
},
"bank_transaction_code": "PMNT-RCDT-ESCT",
"bank_reference": "2026111800009876",
"identity_quality": "bank_reference",
"end_to_end_id": "2026-0418",
"mandate_id": null,
"creditor_id": null,
"merchant_category_code": null,
"exchange": null,
"balance_after": "19460.34",
"category": "income",
"first_seen_at": "2026-11-19T06:00:10Z",
"updated_at": "2026-11-19T06:00:10Z"
}
],
"next_page_token": null,
"has_more": false
}null.
To keep a copy in step, use the change feed instead of re-reading ranges.Authorizations
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.
Query Parameters
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.