Pular para o conteúdo principal
GET
curl
O endpoint Get an Institution da Didit retorna um banco com suas capacidades e seu status. Um valor que nunca foi observado é null, não uma suposição.

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

id
string
obrigatório

O ID da instituição, por exemplo es-banco-norte.

Resposta

O banco.

Um banco e o que ele suporta. Os valores vêm de dados de capacidade observados, atualizados diariamente; um valor nunca observado é null, não um palpite.

id
string
obrigatório

Identificador do banco na Didit, um slug estável.

Exemplo:

"es-banco-norte"

name
string
obrigatório
country
string
obrigatório
Pattern: ^[A-Z]{3}$
logo_url
string<uri> | null
obrigatório
timezone
string | null
obrigatório

Fuso horário IANA das datas do banco.

segments
enum<string>[]
obrigatório
Opções disponíveis:
personal,
business
access
enum<string>[]
obrigatório

ongoing aparece na lista apenas onde o acesso contínuo está ativado para o banco.

Opções disponíveis:
one_time,
ongoing
ongoing_access
boolean
obrigatório

Se o acesso contínuo está disponível neste banco.

O consentimento mais longo que o banco permite, em dias. null quando não foi observado.

history_days_max
integer | null
obrigatório

O histórico mais profundo que o banco entrega, em dias. null quando não foi observado.

pending_transactions
boolean | null
obrigatório

Se o banco informa transações pendentes.

pending_linkage
boolean | null
obrigatório

Se o banco vincula uma transação pendente à transação lançada, o que define pending_id.

balance_types
enum<string>[]
obrigatório
Opções disponíveis:
booked,
available,
expected
transaction_fields
string[]
obrigatório

Os campos da transação que se sabe que o banco envia. Todos os outros campos são null.

sign_in
enum<string> | null
obrigatório

Como a pessoa faz login no banco.

Opções disponíveis:
redirect,
app_approval,
credentials,
null
requires_end_user_email
boolean | null
obrigatório

Se o Bank Link exige um endereço de e-mail verificado para a pessoa.

corporate_accounts
boolean | null
obrigatório

Se contas empresariais são suportadas.

bank_account_selection
boolean | null
obrigatório

Se a pessoa escolhe as contas no banco, em vez de no Bank Link.

Se o banco pede mais uma confirmação para liberar o histórico mais antigo.

reconfirmation
boolean | null
obrigatório

Se uma renovação pode ser reconfirmada na tela da Didit sem um login no banco.

sync_frequency_hours
integer | null
obrigatório

Horas entre sincronizações automáticas, quando o banco permite uma cadência mais rápida. null significa o padrão diário.

health
enum<string>
obrigatório
Opções disponíveis:
operational,
degraded,
down
Última modificação em 22 de novembro de 2026