curl 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.get_connection(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.getConnection("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.GetConnection(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().getConnection("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->getConnection('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.get_connection("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.GetConnectionAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"environment": "live",
"access": "ongoing",
"status": "active",
"status_reason": null,
"institution": {
"id": "es-banco-norte",
"name": "Banco Norte",
"country": "ESP",
"logo_url": "https://static.example.com/banks/es-banco-norte.png"
},
"segment": "business",
"data": [
"accounts",
"balances",
"transactions"
],
"consent": {
"status": "granted",
"version": 1,
"granted_at": "2026-11-21T12:04:11Z",
"expires_at": "2027-05-20T12:04:11Z",
"days_granted": 180,
"renewed_count": 0,
"scopes_requested": [
"accounts",
"balances",
"transactions"
],
"scopes_granted": [
"accounts",
"balances",
"transactions"
],
"accounts_granted": [
"a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72"
],
"renewal_action": "bank_auth",
"renew_by": "2027-05-20T12:04:11Z",
"reconfirm_by": null,
"renewable_until": null,
"retain_until": null,
"ended_at": null,
"ended_by": null
},
"sync": {
"status": "ok",
"initial_status": "succeeded",
"initial_complete": true,
"history_complete": true,
"last_synced_at": "2026-11-21T12:04:40Z",
"next_sync_at": "2026-11-22T06:00:00Z",
"budgets": [
{
"scope": "connection",
"resource": "all",
"limit": 4,
"remaining": 3,
"resets_at": "2026-11-22T00:00:00Z"
}
],
"last_error": null,
"frequency_per_day": 1,
"live_syncs_left_today": 3
},
"accounts": [
{
"id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"name": "Cuenta negocio",
"type": "current",
"usage": "business",
"currency": "EUR",
"iban_last4": "1332",
"status": "open"
},
{
"id": "c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72",
"name": "Cuenta de ahorro",
"type": "savings",
"usage": "business",
"currency": "EUR",
"iban_last4": "7708",
"status": "open"
}
],
"ownership": {
"compare": "none",
"match": null,
"check_id": null,
"result": null
},
"end_user": {
"reference": "client-7731"
},
"manage_url": null,
"billing": {
"unit": "connection_month",
"price_usd": "0.9000",
"billed_through": "2026-11-30"
},
"possible_duplicate_of": null,
"erasure": null,
"vendor_data": "client-7731",
"created_at": "2026-11-21T12:03:02Z",
"updated_at": "2026-11-21T12:04:40Z"
}API Récupérer une connexion bancaire : consentement, synchronisation et comptes
L’endpoint Didit Get a Bank Connection renvoie une connexion avec statut, dates de consentement, synchronisation, comptes et coût.
curl 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.get_connection(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.getConnection("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.GetConnection(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().getConnection("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->getConnection('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.get_connection("11111111-2222-3333-4444-555555555555")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.GetConnectionAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"environment": "live",
"access": "ongoing",
"status": "active",
"status_reason": null,
"institution": {
"id": "es-banco-norte",
"name": "Banco Norte",
"country": "ESP",
"logo_url": "https://static.example.com/banks/es-banco-norte.png"
},
"segment": "business",
"data": [
"accounts",
"balances",
"transactions"
],
"consent": {
"status": "granted",
"version": 1,
"granted_at": "2026-11-21T12:04:11Z",
"expires_at": "2027-05-20T12:04:11Z",
"days_granted": 180,
"renewed_count": 0,
"scopes_requested": [
"accounts",
"balances",
"transactions"
],
"scopes_granted": [
"accounts",
"balances",
"transactions"
],
"accounts_granted": [
"a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72"
],
"renewal_action": "bank_auth",
"renew_by": "2027-05-20T12:04:11Z",
"reconfirm_by": null,
"renewable_until": null,
"retain_until": null,
"ended_at": null,
"ended_by": null
},
"sync": {
"status": "ok",
"initial_status": "succeeded",
"initial_complete": true,
"history_complete": true,
"last_synced_at": "2026-11-21T12:04:40Z",
"next_sync_at": "2026-11-22T06:00:00Z",
"budgets": [
{
"scope": "connection",
"resource": "all",
"limit": 4,
"remaining": 3,
"resets_at": "2026-11-22T00:00:00Z"
}
],
"last_error": null,
"frequency_per_day": 1,
"live_syncs_left_today": 3
},
"accounts": [
{
"id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"name": "Cuenta negocio",
"type": "current",
"usage": "business",
"currency": "EUR",
"iban_last4": "1332",
"status": "open"
},
{
"id": "c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72",
"name": "Cuenta de ahorro",
"type": "savings",
"usage": "business",
"currency": "EUR",
"iban_last4": "7708",
"status": "open"
}
],
"ownership": {
"compare": "none",
"match": null,
"check_id": null,
"result": null
},
"end_user": {
"reference": "client-7731"
},
"manage_url": null,
"billing": {
"unit": "connection_month",
"price_usd": "0.9000",
"billed_through": "2026-11-30"
},
"possible_duplicate_of": null,
"erasure": null,
"vendor_data": "client-7731",
"created_at": "2026-11-21T12:03:02Z",
"updated_at": "2026-11-21T12:04:40Z"
}sync.initial_status indique à partir de quand les premières données sont lisibles, consent.expires_at indique quand renouveler le consentement, et sync.budgets indique combien de rafraîchissements la banque autorise encore.
Voir Connexions.Autorisations
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.
Réponse
La connexion.
L'autorisation accordée par la personne à votre application pour lire une banque. Un renouvellement conserve l'identifiant de connexion et tous les identifiants de compte. Une connexion supprimée ne renvoie que id, status, status_reason, created_at et erasure : tous les autres champs sont absents, et aucune donnée de banque, de personne ou de compte n'y subsiste.
pending : première synchronisation en cours. active : consentement valide. renewal_required : le consentement a pris fin ou la banque demande à la personne de se reconnecter ; les données restent lisibles telles que synchronisées en dernier et rien n'est facturé. paused : solde insuffisant pour le mois. revoked : accès interrompu par la personne, la banque ou vous. deleted : seuls id, status, status_reason, created_at et erasure subsistent. failed : la première synchronisation n'a jamais réussi.
pending, active, renewal_required, paused, revoked, deleted, failed Pourquoi la connexion se trouve dans ce statut. paused_by_customer est réservé. Pour une connexion deleted : deleted_by_customer, consent_lapsed, retention_elapsed ou application_deleted.
collection_complete, consent_expired, consent_lapsed, bank_requires_sign_in, revoked_by_end_user, revoked_by_bank, revoked_by_customer, insufficient_balance, paused_by_customer, first_sync_failed, deleted_by_customer, retention_elapsed, application_deleted, null