Saltar al contingut principal
GET
curl
L’endpoint Get an Account de Didit retorna un compte amb els seus identificadors, titulars, frescor de la sincronització i cobertura de l’historial. sync.last_synced_at és el moment en què Didit va obtenir les dades del banc per última vegada. Per obtenir els identificadors complets cal el permís de dades bancàries a la teva clau. Consulta Comptes, saldos i transaccions.

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 ruta

account_id
string<uuid>
requerit

L'id del compte.

Resposta

El compte.

Un compte dins d'una connexió.

id
string<uuid>
requerit

Identificador del compte. Pertany a la connexió i no canvia mentre existeixi, inclosos els renovaments.

connection_id
string<uuid>
requerit
name
string | null
requerit
product
string | null
requerit

El nom del producte del banc.

type
enum<string>
requerit
Opcions disponibles:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
requerit
Opcions disponibles:
personal,
business,
unknown
currency
string
requerit

Codi de moneda ISO 4217.

Pattern: ^[A-Z]{3}$
holder_name
string | null
requerit

Nom del titular quan el banc el comparteix.

holders
object[]
requerit

Titulars que el banc comparteix. La titularitat només compta holder i joint_holder.

identifiers
object
requerit

Identificadors complets, retornats a les crides del costat del servidor amb el permís de dades bancàries.

account_ref
string | null
requerit

Identifica el mateix compte bancari entre connexions d'una mateixa aplicació i entorn: un hash amb clau dels identificadors propis del banc. null quan el banc no facilita cap identificador fiable. Utilitza'l per reconèixer un compte bancari que ja coneixes.

account_ref_previous
string | null
requerit

L'account_ref anterior, només per a un àlies verificat, com una migració de banc.

status
enum<string>
requerit

access_removed: la persona ha eliminat el compte del consentiment. Ja no es sincronitza.

Opcions disponibles:
open,
closed,
access_removed
scopes_granted
enum<string>[]
requerit
Opcions disponibles:
accounts,
balances,
transactions
sync
object
requerit
history_coverage
object
requerit

Què ha lliurat el banc de l'historial que has sol·licitat.

Darrera modificació el 22 de novembre del 2026