Passer au contenu principal
GET
curl
L’endpoint « Get an Account » de Didit renvoie un compte avec ses identifiants, ses titulaires, la récence de sa synchronisation et la couverture de son historique. sync.last_synced_at indique le moment où Didit a récupéré pour la dernière fois les données auprès de la banque. Les identifiants complets nécessitent l’autorisation d’accès aux données bancaires activée sur votre clé. Voir Comptes, soldes et transactions.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, disponible dans Developers -> API keys de la Business Console. La clé principale a un accès complet. Une clé nommée peut être limitée : aucun accès, lecture ou écriture par ressource, restreinte à certains workflows ou à certaines sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou à cette action, ou que la requête provient d'une adresse hors de sa liste d'adresses IP ; 404 sur une route de session signifie que la session se trouve hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL des images, vidéos et PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

account_id
string<uuid>
requis

L'identifiant du compte.

Réponse

Le compte.

Un compte au sein d'une connexion.

id
string<uuid>
requis

Identifiant du compte. Il appartient à la connexion et ne change jamais tant qu'il existe, renouvellements inclus.

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

Le nom du produit de la banque.

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

Code de devise ISO 4217.

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

Nom du titulaire lorsque la banque le transmet.

holders
object[]
requis

Titulaires transmis par la banque. Seuls holder et joint_holder sont pris en compte pour l'actionnariat.

identifiers
object
requis

Identifiants complets, renvoyés aux appelants côté serveur disposant de l'autorisation sur les données bancaires.

account_ref
string | null
requis

Identifie un même compte bancaire entre les connexions d'une même application et d'un même environnement : il s'agit d'un hachage à clé des identifiants propres à la banque. null lorsque la banque ne fournit aucun identifiant fiable. Utilisez-le pour reconnaître un compte bancaire déjà connu.

account_ref_previous
string | null
requis

Le account_ref précédent, uniquement pour un alias vérifié, comme lors d'une migration bancaire.

status
enum<string>
requis

access_removed : la personne a retiré le compte du périmètre du consentement. Il n'est plus synchronisé.

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

Ce que la banque a livré de l'historique demandé.

Dernière modification le 22 novembre 2026