Conta
Dados da conta
Consulta dados cadastrais da conta autenticada
Retorna os dados cadastrais da conta associada ao token (ISPB, agência, conta, titular).
Referência API: GET /api/v2/contas.
Request
GET /api/v2/contas
Authorization: Bearer {access_token}
Accept: application/json
Sem query params.
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | Sim | Bearer {{access_token}} |
Accept | Sim | application/json |
Scope: contas.read.
curl --location 'https://api-h.nuvende.com.br/api/v2/contas' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{access_token}}'
Response 200
{
"ispb": "12345678",
"agencia": "0001",
"conta": "1234567",
"dataAbertura": "2024-01-20T10:30:00.000000Z",
"tipo": "CACC",
"pessoa": {
"nome": "Empresa XYZ LTDA",
"cpfCnpj": "12345678000199",
"nomeFantasia": "Empresa XYZ",
"logradouro": "Rua Exemplo, 100",
"cidade": "Sao Paulo",
"uf": "SP",
"tipo": "PJ"
},
"correlationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
| Campo | Descrição |
|---|---|
ispb | ISPB da instituição (8 dígitos) |
agencia | Agência |
conta | Número da conta (com DV) |
dataAbertura | Data de abertura |
tipo | Tipo de conta (ex.: CACC, SVGS) |
pessoa | Dados do titular |
pessoa.tipo | PF ou PJ |
correlationId | ID de correlação |
Response 400
Conta não encontrada:
{
"type": "https://pix.bcb.gov.br/api/v2/error/OperacaoInvalida",
"title": "Conta não encontrada",
"status": 400,
"detail": "Requisição no formato inválido, ou realizando alguma operação não permitida"
}