Saltar al contingut principal
GET
curl
El endpoint de Didit per llistar connexions bancàries retorna les teves connexions, filtrades per estat, accés, banc, país, les teves pròpies referències i la data de finalització del consentiment. Fes servir consent_expires_before per trobar els consentiments que cal renovar i end_user_reference per trobar les connexions d’un client. La llista es pagina amb cursor.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau principal té accés complet. Una clau amb nom es pot limitar: cap, lectura o escriptura per recurs, limitada a alguns fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 vol dir que la clau és incorrecta, revocada o caducada; 403 vol dir que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud ve d'una adreça fora de la seva llista d'adreces IP; 404 en una ruta de sessió vol dir que la sessió queda fora dels fluxos de treball o estats de la clau. Una clau sense accés a multimèdia rep les URL d'imatges, vídeos i PDF com a null, i una clau sense escriptura de sessions rep els enllaços i els tokens de sessió com a null. Vegeu https://docs.didit.me/console/api-keys.

Paràmetres de consulta

status
enum<string>

Només connexions en aquest estat.

Opcions disponibles:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

Només aquest mode d'accés.

Opcions disponibles:
one_time,
ongoing
institution_id
string

Només aquest banc.

Maximum string length: 64
country
string

Només bancs d'aquest país.

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

Només connexions amb aquest vendor_data.

Maximum string length: 255
end_user_reference
string

Només connexions amb aquest end_user.reference.

Maximum string length: 255

Només connexions el consentiment de les quals acaba abans d'aquest moment, per exemple per enviar enllaços de renovació.

created_after
string<date-time>

Només connexions creades després d'aquest moment.

limit
integer
predeterminat:100

Mida de pàgina, de 1 a 500. Per defecte, 100.

Rang requerit: 1 <= x <= 500
cursor
string

Cursor opac del next_cursor de la pàgina anterior.

Resposta

Una pàgina de connexions.

Una pàgina de connexions.

items
object[]
requerit
next_cursor
string | null
requerit

Passa'l com a cursor per a la pàgina següent. null a l'última pàgina.

Darrera modificació el 22 de novembre del 2026