Skip to main content
GET
curl
Didit’s List Bank Connections endpoint returns your connections, filtered by status, access, bank, country, your own references and consent end date. Use consent_expires_before to find consents that need renewing and end_user_reference to find the connections of one client. The list is paginated with cursor.

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.

Query Parameters

status
enum<string>

Only connections in this status.

Available options:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

Only this access mode.

Available options:
one_time,
ongoing
institution_id
string

Only this bank.

Maximum string length: 64
country
string

Only banks in this country.

Pattern: ^[A-Z]{3}$
vendor_data
string

Only connections with this vendor_data.

Maximum string length: 255
end_user_reference
string

Only connections with this end_user.reference.

Maximum string length: 255

Only connections whose consent ends before this time, for example to send renew links.

created_after
string<date-time>

Only connections created after this time.

limit
integer
default:100

Page size, 1 to 500. Default 100.

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

Opaque cursor from the previous page's next_cursor.

Response

A page of connections.

A page of connections.

items
object[]
required
next_cursor
string | null
required

Pass as cursor for the next page. null on the last page.

Last modified on November 22, 2026