---
title: "Banking Statement API"
url: "https://devcenter.stone.com.br/apis/banking-statement/versions/6cf07218-05b9-47de-a54e-a2fcbd87ce72"
---

# Banking Statement API

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Banking Statement API","version":"1.0.0","description":"Consulta do extrato consolidado de transações da conta de pagamento Stone (Conta Stone / Banking)"},"servers":[{"url":"https://api.stone.com.br","description":"Produção"},{"url":"https://sdx.api.stone.com.br","description":"Sandbox"}],"tags":[{"name":"Statement","description":"Extrato da conta de pagamento."}],"paths":{"/v1/accounts/statement":{"get":{"operationId":"getAccountStatement","tags":["Statement"],"summary":"Consultar extrato da conta","description":"Retorna o extrato consolidado de transações da conta associada à API Key autenticada, com suporte a filtros avançados e paginação por cursor.","security":[{"basicAuth":[]}],"parameters":[{"name":"after","in":"query","required":false,"description":"Cursor de paginação para buscar a próxima página de resultados.","schema":{"type":"string","example":"MTU4Nzc5Nzg2MA=="}},{"name":"before","in":"query","required":false,"description":"Cursor de paginação para buscar a página anterior de resultados.","schema":{"type":"string","example":"MTU4Nzc5Nzg2MA=="}},{"name":"limit","in":"query","required":false,"description":"Número máximo de registros a serem retornados por página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"start_datetime","in":"query","required":false,"description":"Data e hora inicial para filtrar as operações (formato RFC3339).","schema":{"type":"string","format":"date-time","example":"2025-11-26T00:00:00Z"}},{"name":"end_datetime","in":"query","required":false,"description":"Data e hora final para filtrar as operações (formato RFC3339).","schema":{"type":"string","format":"date-time","example":"2025-11-26T00:00:00Z"}},{"name":"created_at_start","in":"query","required":false,"description":"Data e hora inicial de criação para filtragem (formato RFC3339).","schema":{"type":"string","format":"date-time","example":"2025-11-26T00:00:00Z"}},{"name":"created_at_end","in":"query","required":false,"description":"Data e hora final de criação para filtragem (formato RFC3339).","schema":{"type":"string","format":"date-time","example":"2025-11-26T00:00:00Z"}},{"name":"type","in":"query","required":false,"description":"Lista de tipos de operação para filtrar os resultados, enviada como uma lista separada por vírgulas (ex: `type=inbound_pix,outbound_pix`). Valores conhecidos incluem inbound_pix, outbound_pix, pix_payment, pix_payment_pos, internal, investment e generic. Esta lista não é exaustiva.","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"example":["inbound_pix","outbound_pix"]}},{"name":"operation","in":"query","required":false,"description":"Filtra pela direção da operação.","schema":{"type":"string","enum":["debit","credit"]}}],"responses":{"200":{"description":"Extrato da conta retornado com sucesso.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatementResponse"},"example":{"cursor":{"after":"MTU4Nzc5Nzg2MA==","before":null,"limit":25},"data":[{"id":"019abffc-ab56-85bc-8000-00005aa24aea","account_id":"93bc3e42-2270-4c33-b2b9-8dc38f074156","amount":3375,"fee_amount":0,"operation_amount":3375,"created_at":"2025-11-26T11:46:38.550367Z","created_at_ts":"11:46:38.550","operation_id":"e4c4f062-0da1-4072-a9bb-6953fc61e077","operation":"credit","type":"inbound_pix","balance_after":45064933,"balance_before":45061558,"title":"John Doe","subtitle":"Transferência | Pix","counterparty_agent":{"account":{"account_code":"7465438","branch_code":null,"account_type":"PG"},"entity":{"name":"John Doe","document_type":"cpf","document":"36476427890"},"institution":{"ispb":"16501555","compe":"197","name":"STONE INSTITUIÇÃO DE PAGAMENTO S.A."}}}]}}}},"400":{"description":"Requisição inválida / parâmetros malformados.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"example":{"type":"about:blank","title":"Bad Request","status":400,"detail":"Formato de data inválido para o parâmetro start_datetime"}}}},"401":{"description":"Token de autenticação inválido ou ausente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"example":{"type":"about:blank","title":"Unauthorized","status":401,"detail":"Token de autenticação ausente ou inválido"}}}},"422":{"description":"Erro de validação nos parâmetros fornecidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"example":{"type":"about:blank","title":"Unprocessable Entity","status":422,"detail":"O parâmetro limit deve estar entre 1 e 100"}}}},"500":{"description":"Erro interno do servidor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"},"example":{"type":"about:blank","title":"Internal Server Error","status":500,"detail":"Ocorreu um erro inesperado"}}}}}}}},"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"HTTP Basic Auth no header `Authorization`."}},"schemas":{"StatementResponse":{"type":"object","required":["cursor","data"],"properties":{"cursor":{"$ref":"#/components/schemas/Cursor"},"data":{"type":"array","description":"Lista de registros de transações.","items":{"$ref":"#/components/schemas/Transaction"}}}},"Cursor":{"type":"object","description":"Metadados de paginação.","required":["limit"],"properties":{"after":{"type":"string","nullable":true,"description":"Cursor apontando para a próxima página."},"before":{"type":"string","nullable":true,"description":"Cursor apontando para a página anterior."},"limit":{"type":"integer","description":"Número máximo de registros por página.","example":25}}},"Transaction":{"type":"object","required":["id","account_id","amount","operation","type","created_at","balance_before","balance_after"],"properties":{"id":{"type":"string","format":"uuid","description":"Identificador único da transação."},"account_id":{"type":"string","format":"uuid","description":"Identificador da conta associada à transação."},"amount":{"type":"integer","format":"int64","description":"Valor da transação em centavos (menor unidade da moeda)."},"fee_amount":{"type":"integer","format":"int64","description":"Valor da taxa cobrada na transação, em centavos."},"operation_amount":{"type":"integer","format":"int64","description":"Valor líquido da operação, em centavos. Pode incluir ou excluir taxas dependendo do contexto."},"created_at":{"type":"string","format":"date-time","description":"Data e hora de criação da transação (UTC, ISO 8601)."},"created_at_ts":{"type":"string","description":"Componente de hora da criação da transação (HH:mm:ss.SSS).","example":"11:46:38.550"},"operation_id":{"type":"string","format":"uuid","description":"Identificador da operação relacionada."},"operation":{"type":"string","description":"Direção da movimentação.","enum":["credit","debit"]},"type":{"type":"string","description":"Tipo da transação. Valores conhecidos incluem inbound_pix, outbound_pix, pix_payment, pix_payment_pos, internal, investment e generic. Esta lista não é exaustiva.","example":"inbound_pix"},"balance_after":{"type":"integer","format":"int64","description":"Saldo da conta após a transação, em centavos."},"balance_before":{"type":"integer","format":"int64","description":"Saldo da conta antes da transação, em centavos."},"title":{"type":"string","description":"Rótulo principal descrevendo a transação (ex: nome da contraparte)."},"subtitle":{"type":"string","description":"Descrição secundária (ex: \"Transferência | Pix\")."},"counterparty_agent":{"$ref":"#/components/schemas/CounterpartyAgent"}}},"CounterpartyAgent":{"type":"object","description":"Informações sobre a contraparte envolvida na transação.","properties":{"account":{"$ref":"#/components/schemas/CounterpartyAccount"},"entity":{"$ref":"#/components/schemas/CounterpartyEntity"},"institution":{"$ref":"#/components/schemas/CounterpartyInstitution"}}},"CounterpartyAccount":{"type":"object","description":"Detalhes da conta da contraparte.","properties":{"account_code":{"type":"string","description":"Número/código da conta."},"branch_code":{"type":"string","nullable":true,"description":"Código da agência, se aplicável."},"account_type":{"type":"string","description":"Tipo de conta. Valores observados: PG, CC, PP, CD, CG."}}},"CounterpartyEntity":{"type":"object","description":"Detalhes de identidade da contraparte.","properties":{"name":{"type":"string","description":"Nome da contraparte."},"document_type":{"type":"string","description":"Tipo de documento (ex: cpf, cnpj)."},"document":{"type":"string","description":"Número do documento."}}},"CounterpartyInstitution":{"type":"object","description":"Detalhes da instituição financeira.","properties":{"ispb":{"type":"string","description":"Código ISPB (identificador do sistema de pagamentos brasileiro)."},"compe":{"type":"string","description":"Código COMPE (identificador do banco)."},"name":{"type":"string","description":"Nome da instituição."}}},"ProblemDetails":{"type":"object","description":"Payload de erro no formato RFC 7807 (Problem Details), retornado pelas respostas 4xx/5xx.","properties":{"type":{"type":"string","example":"about:blank"},"title":{"type":"string","example":"Bad Request"},"status":{"type":"integer","example":400},"detail":{"type":"string","example":"Formato de data inválido para o parâmetro start_datetime"}}}}}}
```