Vai al contenuto principale
GET
curl
L’endpoint List Bank Connections di Didit restituisce le tue connessioni, filtrate per stato, accesso, banca, paese, tuoi riferimenti e data di scadenza del consenso. Usa consent_expires_before per trovare i consensi da rinnovare e end_user_reference per trovare le connessioni di un singolo cliente. L’elenco è paginato tramite cursor.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere ambiti limitati: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o solo alle sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 significa che la chiave è errata, revocata o scaduta; 403 significa che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo esterno alla sua lista IP; 404 su una route di sessione significa che la sessione è al di fuori dei workflow o degli stati consentiti alla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permesso di scrittura sulle sessioni riceve i link e i token delle sessioni come null. Vedi https://docs.didit.me/console/api-keys.

Parametri della query

status
enum<string>

Solo connessioni in questo stato.

Opzioni disponibili:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

Solo questa modalità di accesso.

Opzioni disponibili:
one_time,
ongoing
institution_id
string

Solo questa banca.

Maximum string length: 64
country
string

Solo banche di questo paese.

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

Solo connessioni con questo vendor_data.

Maximum string length: 255
end_user_reference
string

Solo connessioni con questo end_user.reference.

Maximum string length: 255

Solo connessioni il cui consenso termina prima di questo momento, ad esempio per inviare link di rinnovo.

created_after
string<date-time>

Solo connessioni create dopo questo momento.

limit
integer
predefinito:100

Dimensione della pagina, da 1 a 500. Predefinito: 100.

Intervallo richiesto: 1 <= x <= 500
cursor
string

Cursore opaco dal campo next_cursor della pagina precedente.

Risposta

Una pagina di connessioni.

Una pagina di connessioni.

items
object[]
obbligatorio
next_cursor
string | null
obbligatorio

Passalo come cursor per la pagina successiva. null nell'ultima pagina.

Ultima modifica il 22 novembre 2026