Pular para o conteúdo principal
GET
curl
O endpoint Obter uma conta da Didit retorna uma conta com seus identificadores, titulares, recência da sincronização e cobertura do histórico. sync.last_synced_at indica quando a Didit buscou os dados pela última vez junto ao banco. Os identificadores completos exigem a permissão de dados bancários na sua chave de API. Consulte Contas, saldos e transações.

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, obtida em Developers -> API keys no Business Console. A chave principal tem acesso completo. Uma chave nomeada pode ter escopo limitado: nenhum, leitura ou escrita por recurso, restrita a alguns fluxos ou a sessões aprovadas, a uma lista de endereços e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição partiu de um endereço fora da lista de endereços da chave; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status permitidos para a chave. Uma chave sem acesso a mídia recebe as URLs de imagem, vídeo e PDF como null, e uma chave sem escrita de sessões recebe os links e tokens de sessão como null. Veja https://docs.didit.me/console/api-keys.

Parâmetros de caminho

account_id
string<uuid>
obrigatório

O ID da conta.

Resposta

A conta.

Uma conta dentro de uma conexão.

id
string<uuid>
obrigatório

ID da conta. Pertence à conexão e nunca muda enquanto ela existir, inclusive nas renovações.

connection_id
string<uuid>
obrigatório
name
string | null
obrigatório
product
string | null
obrigatório

O nome do produto bancário.

type
enum<string>
obrigatório
Opções disponíveis:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
obrigatório
Opções disponíveis:
personal,
business,
unknown
currency
string
obrigatório

Código de moeda ISO 4217.

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

Nome do titular, quando o banco o compartilha.

holders
object[]
obrigatório

Titulares que o banco compartilha. Para propriedade, são considerados apenas holder e joint_holder.

identifiers
object
obrigatório

Identificadores completos, retornados a chamadores no servidor com a permissão de dados bancários.

account_ref
string | null
obrigatório

Identifica a mesma conta bancária entre conexões de uma mesma aplicação e ambiente: um hash com chave dos identificadores próprios do banco. null quando o banco não fornece um identificador confiável. Use-o para reconhecer uma conta bancária que você já conhece.

account_ref_previous
string | null
obrigatório

O account_ref anterior, apenas para um alias verificado, como uma migração de banco.

status
enum<string>
obrigatório

access_removed: a pessoa removeu a conta do consentimento. Ela não é mais sincronizada.

Opções disponíveis:
open,
closed,
access_removed
scopes_granted
enum<string>[]
obrigatório
Opções disponíveis:
accounts,
balances,
transactions
sync
object
obrigatório
history_coverage
object
obrigatório

O que o banco entregou do histórico que você solicitou.

Última modificação em 22 de novembro de 2026