---
title: "Consultar extrato da conta"
url: "https://devcenter.stone.com.br/apis/banking-statement/versions/6cf07218-05b9-47de-a54e-a2fcbd87ce72/operations/getAccountStatement"
---

> Full API specification: https://devcenter.stone.com.br/apis/banking-statement/versions/6cf07218-05b9-47de-a54e-a2fcbd87ce72.md

# Consultar extrato da conta

`GET` `/v1/accounts/statement`

Operation ID: `getAccountStatement`

Retorna o extrato consolidado de transações da conta associada à API Key autenticada, com suporte a filtros avançados e paginação por cursor.

## Query parameters

- `after` (string, optional) - Cursor de paginação para buscar a próxima página de resultados.
- `before` (string, optional) - Cursor de paginação para buscar a página anterior de resultados.
- `limit` (integer, optional) - Número máximo de registros a serem retornados por página.
- `start_datetime` (string, date-time, optional) - Data e hora inicial para filtrar as operações (formato RFC3339).
- `end_datetime` (string, date-time, optional) - Data e hora final para filtrar as operações (formato RFC3339).
- `created_at_start` (string, date-time, optional) - Data e hora inicial de criação para filtragem (formato RFC3339).
- `created_at_end` (string, date-time, optional) - Data e hora final de criação para filtragem (formato RFC3339).
- `type` (array, optional) - 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.
- `operation` (string, optional) - Filtra pela direção da operação.

## Responses

- `200` - Extrato da conta retornado com sucesso.
- `400` - Requisição inválida / parâmetros malformados.
- `401` - Token de autenticação inválido ou ausente.
- `422` - Erro de validação nos parâmetros fornecidos.
- `500` - Erro interno do servidor.

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Banking Statement API
  version: 1.0.0
servers:
  - url: https://api.stone.com.br
    description: Produção
  - url: https://sdx.api.stone.com.br
    description: Sandbox
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
security:
  - basicAuth: []
components:
  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"
    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
    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.
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic Auth no header `Authorization`.
```