API de Extratos v2
GET /v2/conta-corrente/agencia/{agencia}/conta/{conta}
Homologação: https://extratos.mtls.api.hm.bb.com.br/v2
Produção: https://extratos.mtls.api.bb.com.br/v2
Autenticação e segurança
- Bearer Token no header Authorization.
- Certificado de cliente mTLS.
x-br-com-bb-ipa-mcitestesomente em homologação.
Query params
| Campo | Regra |
|---|---|
gw-dev-app-key |
Obrigatório |
dataInicioSolicitacao |
DDMMAAAA; exige data final |
dataFimSolicitacao |
DDMMAAAA; exige data inicial |
numeroPaginaSolicitacao |
Padrão 1 |
quantidadeRegistroPaginaSolicitacao |
50 a 120 |
Resposta
Envelope com numeroPaginaAtual, numeroPaginaProximo, quantidadeTotalRegistro e listaLancamento.
Limites
- Período máximo de 31 dias.
- Histórico de até 5 anos.
- Sem datas: últimos 30 dias.
- Máximo de 120 registros por página.
Exigência do BB x o que foi implantado
Documentação BB
Endpoint, mTLS, Bearer, headers, parâmetros, paginação, campos e HTTP.
O que foi implantado
Normalização, SHA-256, índice único, persistência, logs e entrega ao ERP.