Vai al contenuto principale
GET
curl
L’endpoint Get an Account di Didit restituisce un singolo conto con i suoi identificativi, i titolari, lo stato di aggiornamento della sincronizzazione e la copertura dello storico. sync.last_synced_at indica quando Didit ha recuperato per l’ultima volta i dati dalla banca. Per visualizzare gli identificativi completi è necessaria l’autorizzazione per i dati bancari sulla tua chiave API. Consulta Conti, saldi e transazioni.

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 del percorso

account_id
string<uuid>
obbligatorio

L'id del conto.

Risposta

Il conto.

Un conto all'interno di una connessione.

id
string<uuid>
obbligatorio

ID dell'account. Appartiene alla connessione e non cambia mai finché esiste, rinnovi inclusi.

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

Il nome del prodotto della banca.

type
enum<string>
obbligatorio
Opzioni disponibili:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
obbligatorio
Opzioni disponibili:
personal,
business,
unknown
currency
string
obbligatorio

Codice valuta ISO 4217.

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

Nome del titolare, dove la banca lo condivide.

holders
object[]
obbligatorio

Titolari condivisi dalla banca. Nell'assetto proprietario contano solo holder e joint_holder.

identifiers
object
obbligatorio

Identificativi completi, restituiti ai chiamanti lato server con l'autorizzazione ai dati bancari.

account_ref
string | null
obbligatorio

Identifica lo stesso conto bancario tra le connessioni di una stessa applicazione e ambiente: un hash con chiave degli identificativi propri della banca. null quando la banca non fornisce un identificativo affidabile. Usalo per riconoscere un conto bancario già noto.

account_ref_previous
string | null
obbligatorio

Il precedente account_ref, solo per un alias verificato, come una migrazione bancaria.

status
enum<string>
obbligatorio

access_removed: la persona ha rimosso il conto dal consenso. Non viene più sincronizzato.

Opzioni disponibili:
open,
closed,
access_removed
scopes_granted
enum<string>[]
obbligatorio
Opzioni disponibili:
accounts,
balances,
transactions
sync
object
obbligatorio
history_coverage
object
obbligatorio

Ciò che la banca ha restituito della cronologia richiesta.

Ultima modifica il 22 novembre 2026