> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List account statements

> Lists the account statements of one of your accounts for the `live` or `test` mode of the API key you use. Filter by date range with the `since` and `until` query parameters. The response is paginated. Use `starting_after`, `ending_before`, and `limit` to page through the results. When more results are available, the `Link` response header carries the URL of the next page.

**`v2`** · Base URL `https://api.fintoc.com/v2`


## OpenAPI

````yaml reference/pacioli-api.json GET /accounts/{account_id}/account_statements
openapi: 3.1.0
info:
  title: Fintoc API
  version: v2026-02-01
servers:
  - url: https://api.fintoc.com/v2
security: []
paths:
  /accounts/{account_id}/account_statements:
    get:
      tags:
        - Account statements
      summary: List account statements
      description: >-
        Lists the account statements of one of your accounts for the `live` or
        `test` mode of the API key you use. Filter by date range with the
        `since` and `until` query parameters. The response is paginated. Use
        `starting_after`, `ending_before`, and `limit` to page through the
        results. When more results are available, the `Link` response header
        carries the URL of the next page.
      operationId: account-statements-list
      parameters:
        - name: account_id
          in: path
          required: true
          schema:
            type: string
          description: Unique identifier of the account whose statements you want to list.
        - name: since
          in: query
          required: false
          schema:
            type: string
            example: '2026-01-01'
          description: >-
            Lower bound for the statement period. Returns statements whose
            `end_date` is on or after this ISO 8601 date.
        - name: until
          in: query
          required: false
          schema:
            type: string
            example: '2026-03-31'
          description: >-
            Upper bound for the statement period. Returns statements whose
            `start_date` is on or before this ISO 8601 date.
        - name: starting_after
          in: query
          required: false
          schema:
            type: string
            example: acst_2rNxBkOrlHoOYsZTyQYhA0o8Ek0
          description: >-
            Cursor that fetches the next page of account statements. Use the ID
            of the last account statement from the current page.
        - name: ending_before
          in: query
          required: false
          schema:
            type: string
            example: acst_2rNxBkOrlHoOYsZTyQYhA0o8Ek0
          description: >-
            Cursor that fetches the previous page of account statements. Use the
            ID of the first account statement from the current page.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            example: 50
          description: >-
            Maximum number of account statements to return per page. Ranges from
            `1` to `300`. Defaults to `30`.
      responses:
        '200':
          description: List of account statements for the account.
          headers:
            Link:
              schema:
                type: string
              description: >-
                Standard HTTP `Link` header carrying the URL of the next page,
                as defined by Request for Comments (RFC) 8288. Present only when
                more results are available.
          content:
            application/json:
              examples:
                account_statements_list:
                  value:
                    - id: acst_2daFu0zqqDtZGJaSi2TGI2Mm1nN
                      object: account_statement
                      created_at: '2026-03-01T12:00:00.000Z'
                      download_url: https://fintoc.com/account_statements/astmt.pdf
                      end_date: '2026-02-28'
                      final_balance_cents: 1500000
                      initial_balance_cents: 1000000
                      start_date: '2026-02-01'
                      total_credited_cents: 1000000
                      total_debited_cents: 500000
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/account_statement'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              examples:
                invalid_api_key:
                  value:
                    error:
                      type: authentication_error
                      code: invalid_api_key
                      message: 'Invalid API Key: invalid-*oken'
              schema:
                $ref: '#/components/schemas/error_object'
        '404':
          description: The account does not exist in your organization.
          content:
            application/json:
              examples:
                account_not_found:
                  value:
                    error:
                      type: invalid_request_error
                      code: resource_not_found
                      message: 'Account not found: acc_8htRZ3kLpWqVnXc4MdYbF1Ej'
              schema:
                $ref: '#/components/schemas/error_object'
      security:
        - api_key: []
components:
  schemas:
    account_statement:
      type: object
      description: >-
        The `account_statement` object represents a periodic summary of one of
        your accounts. Each statement covers the range from `start_date` to
        `end_date` and reports the opening and closing balances, the totals
        credited and debited during the period, and a link to download the
        statement as a PDF.
      properties:
        id:
          type: string
          description: Unique identifier of the account statement.
          example: acst_2daFu0zqqDtZGJaSi2TGI2Mm1nN
        object:
          const: account_statement
          description: Type of the object. Always `account_statement`.
        created_at:
          type: string
          format: date-time
          description: >-
            Point in time when Fintoc generated the statement, as an ISO 8601
            datetime in UTC.
          example: '2026-03-01T12:00:00.000Z'
        download_url:
          type:
            - string
            - 'null'
          description: >-
            URL to download the statement PDF. `null` when the file is not yet
            available.
          example: https://fintoc.com/account_statements/astmt.pdf
        end_date:
          type: string
          format: date
          description: Last day covered by the statement, as an ISO 8601 date.
          example: '2026-02-28'
        final_balance_cents:
          type: integer
          description: >-
            Account balance at the end of the period, in the smallest currency
            unit.
          example: 1500000
        initial_balance_cents:
          type: integer
          description: >-
            Account balance at the start of the period, in the smallest currency
            unit.
          example: 1000000
        start_date:
          type: string
          format: date
          description: First day covered by the statement, as an ISO 8601 date.
          example: '2026-02-01'
        total_credited_cents:
          type: integer
          description: Total credited during the period, in the smallest currency unit.
          example: 1000000
        total_debited_cents:
          type: integer
          description: Total debited during the period, in the smallest currency unit.
          example: 500000
      required:
        - id
        - object
        - created_at
        - download_url
        - end_date
        - final_balance_cents
        - initial_balance_cents
        - start_date
        - total_credited_cents
        - total_debited_cents
    error_object:
      type: object
      properties:
        error:
          type: object
          description: Details of the error that caused the request to fail.
          properties:
            code:
              type: string
              description: >-
                Machine-readable code identifying the specific error, for
                example `invalid_request`.
              example: invalid_request
            doc_url:
              type: string
              description: >-
                URL of a documentation page with more details about the error.
                Not returned by every error.
              example: https://docs.fintoc.com/reference/errors
            message:
              type: string
              description: Human-readable message describing the error.
              example: 'Missing required param: account_id'
            param:
              type:
                - string
                - 'null'
              description: >-
                Name of the request parameter that caused the error. Not
                returned by every error.
              example: account_id
            type:
              type: string
              description: >-
                Category of the error, for example `invalid_request_error` or
                `authentication_error`. Not returned by every error.
              example: invalid_request_error
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      in: header

````