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

# List Bank Account Transactions

> List transactions



## OpenAPI

````yaml v2/api-reference/openapi.json GET /v2/bank_accounts/{id}/transactions
openapi: 3.0.0
info:
  title: Trio API v2
  version: 2026-10-19.v2
servers:
  - url: https://api.sandbox.trio.com.br
    variables: {}
  - url: https://api.qa.trio.com.br
    variables: {}
  - url: https://api.trio.com.br
    variables: {}
security: []
tags: []
paths:
  /v2/bank_accounts/{id}/transactions:
    parameters:
      - description: >-
          Version of the v2 contract the client is written against. Each
          breaking change publishes a new version.
        example: 2026-10-19.v2
        in: header
        name: Trio-Version
        required: true
        schema:
          enum:
            - 2026-10-19.v2
          type: string
          x-struct: null
          x-validate: null
      - description: >-
          ID of another org to act on instead of the API key's own org. The
          key's org must have been granted access to it, and the request is
          refused with 403 FORBIDDEN otherwise. When that access or the API key
          is read-only, only GET and HEAD requests may carry it. When the target
          org requires mTLS, so does the request. Leave it out to act on the
          key's own org.
        in: header
        name: Trio-Target-Org-Id
        required: false
        schema:
          format: uuid
          type: string
          x-struct: null
          x-validate: null
    get:
      tags:
        - Bank Accounts
        - Transactions
      summary: List transactions
      description: List transactions
      operationId: TrioFoundationWeb.V2.BankAccount.TransactionController.index
      parameters:
        - description: Bank account ID
          in: path
          name: id
          required: true
          schema:
            $ref: '#/components/schemas/UUID'
        - description: External ID
          in: query
          name: external_id
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Reconciliation ID
          in: query
          name: reconciliation_id
          required: false
          schema:
            $ref: '#/components/schemas/UUID'
        - description: From datetime
          in: query
          name: from_datetime
          required: true
          schema:
            $ref: '#/components/schemas/DATETIME'
        - description: To datetime
          in: query
          name: to_datetime
          required: true
          schema:
            $ref: '#/components/schemas/DATETIME'
        - description: >-
            Parameter used for pagination. It is a base64 encoded param used to
            access the previous page of results. It is provided alongside a
            metadata section if there is a previous page.
          example: >-
            g3QAAAABZAACaWRtAAAAJDU4ZjFlYzhlLWFmYTktNDk0My05M2I1LWQ2ZGM3OWI0M2VhYQ==
          in: query
          name: before
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: >-
            Parameter used for pagination. It's a base64 encoded param used to
            access the previous page of results. Provided along with the data in
            the metadata section if there is a previous page.
          example: >-
            g3QAAAABZAACaWRtAAAAJGJhYTNiNmM1LTAyYTYtNGQ5Ny05NzU1LTI3OGFiNjRiN2Y1MQ==
          in: query
          name: after
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/V2_list_bank_account_transactions_response
          description: Transactions
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            Malformed request: a body that is not valid JSON
            (MALFORMED_REQUEST), or a Trio-Version header that is missing or not
            the current one (INVALID_TRIO_VERSION).
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: Missing or invalid API key credentials (INVALID_CREDENTIALS).
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            The API key may not do this (FORBIDDEN): for instance
            Trio-Target-Org-Id names an org it has no access to, or writes
            through a read-only access.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: No resource with this ID (NOT_FOUND_RESOURCE).
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            Invalid input (INVALID_PARAMETER, REQUIRED_PARAMETER, or the code of
            the rule the request breaks). A request outside the operation's
            schema lists the offending fields in `errors`.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            A service needed to answer is unavailable
            (TRIO_SERVICE_UNAVAILABLE).
      callbacks: {}
      security:
        - authorization: []
components:
  schemas:
    UUID:
      description: Unique identifier
      format: uuid
      title: UUID
      type: string
      x-struct: null
      x-validate: null
    DATETIME:
      description: Datetime schema
      format: date-time
      title: DATETIME
      type: string
      x-struct: null
      x-validate: null
    V2_list_bank_account_transactions_response:
      description: A list of transactions of a bank account
      example:
        data:
          - amount:
              amount: 10
              currency: BRL
            bank_account_id: 0190df9a-d08e-9574-c79c-9aa0f40ee330
            counterparty:
              bank_account_id: 0190df9a-d1b1-efb3-7521-55db2415f319
              id: 0191148f-b189-8e42-27a5-1368cc00dea8
              name: John Doe
              tax_number: '11122233344'
            document_type: pix
            end_to_end_id: E44444444202405211946Dwg1pjxgehP
            external_id: external_id
            inserted_at: '2024-07-21T12:00:01.000000Z'
            posting_type: credit
            reconciliation_id: 018f3406-9e00-1766-05c4-4907e14ee511
            ref_id: 0190df9a-d1b1-6bfe-ad26-037579ad8588
            ref_type: in_document
            transaction_date: '2024-07-21T12:00:01.000000Z'
            transaction_type: regular
            updated_at: '2024-07-21T12:00:01.000000Z'
        metadata:
          after: null
          before: null
          has_more: false
      properties:
        data:
          items:
            $ref: '#/components/schemas/V2_bank_account_transaction'
          type: array
          x-struct: null
          x-validate: null
        metadata:
          description: Pagination cursors
          properties:
            after:
              description: Cursor to the next page
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            before:
              description: Cursor to the previous page
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            has_more:
              description: Whether a next page exists
              type: boolean
              x-struct: null
              x-validate: null
          type: object
          x-struct: null
          x-validate: null
      title: V2 list bank account transactions response
      type: object
      x-struct: >-
        Elixir.TrioFoundationWeb.Schemas.Banking.V2.BankAccount.Transaction.ListTransactionResponse
      x-validate: null
    V2_error:
      example:
        error:
          error_code: INVALID_PARAMETER
          error_message: 'Invalid parameters: /amount: Invalid integer. Got: string'
          errors:
            - field: /amount
              message: 'Invalid integer. Got: string'
      properties:
        error:
          properties:
            error_code:
              description: >-
                Stable UPPER_SNAKE identifier of the error, for programs and
                logs. Branch on this, not on the message.
              type: string
              x-struct: null
              x-validate: null
            error_message:
              description: Human readable explanation of the error.
              type: string
              x-struct: null
              x-validate: null
            errors:
              description: >-
                Only on INVALID_PARAMETER for a request outside the operation's
                schema: one entry per offending field.
              items:
                properties:
                  field:
                    description: JSON pointer to the field, e.g. /amount.
                    type: string
                    x-struct: null
                    x-validate: null
                  message:
                    description: What is wrong with it.
                    type: string
                    x-struct: null
                    x-validate: null
                required:
                  - field
                  - message
                type: object
                x-struct: null
                x-validate: null
              type: array
              x-struct: null
              x-validate: null
          required:
            - error_code
            - error_message
          type: object
          x-struct: null
          x-validate: null
      required:
        - error
      title: V2 error
      type: object
      x-struct: Elixir.TrioFoundationWeb.Schemas.HTTP.V2Error
      x-validate: null
    V2_bank_account_transaction:
      description: A transaction of a bank account.
      example:
        amount:
          amount: 10
          currency: BRL
        bank_account_id: 0190df9a-d08e-9574-c79c-9aa0f40ee330
        counterparty:
          bank_account_id: 0190df9a-d1b1-efb3-7521-55db2415f319
          id: 0191148f-b189-8e42-27a5-1368cc00dea8
          name: John Doe
          tax_number: '11122233344'
        document_type: pix
        end_to_end_id: E44444444202405211946Dwg1pjxgehP
        external_id: external_id
        inserted_at: '2024-07-21T12:00:01.000000Z'
        posting_type: credit
        reconciliation_id: 018f3406-9e00-1766-05c4-4907e14ee511
        ref_id: 0190df9a-d1b1-6bfe-ad26-037579ad8588
        ref_type: in_document
        transaction_date: '2024-07-21T12:00:01.000000Z'
        transaction_type: regular
        updated_at: '2024-07-21T12:00:01.000000Z'
      properties:
        amount:
          description: Amount
          properties:
            amount:
              description: Amount in cents
              type: integer
              x-struct: null
              x-validate: null
            currency:
              description: Amount currency
              type: string
              x-struct: null
              x-validate: null
          type: object
          x-struct: null
          x-validate: null
        bank_account_id:
          description: Bank account ID
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        counterparty:
          description: Counterparty of the transaction, all null when it has none
          properties:
            bank_account_id:
              description: Counterparty bank account ID
              format: uuid
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            id:
              description: Counterparty ID
              format: uuid
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            name:
              description: Counterparty name
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            tax_number:
              description: Counterparty tax number
              nullable: true
              type: string
              x-struct: null
              x-validate: null
          type: object
          x-struct: null
          x-validate: null
        document_type:
          description: Kind of operation
          enum:
            - pix
            - boleto
            - ted
            - tef
            - utility
            - tax
            - internal
            - card
            - pix_internal
            - pix_automatic
            - pix_initiation
            - receivable
            - pix_boleto
          type: string
          x-struct: null
          x-validate: null
        end_to_end_id:
          description: End to end ID
          type: string
          x-struct: null
          x-validate: null
        external_id:
          description: External ID
          type: string
          x-struct: null
          x-validate: null
        inserted_at:
          description: Creation date and time
          format: date-time
          type: string
          x-struct: null
          x-validate: null
        posting_type:
          description: Whether the transaction takes money out of or into the account
          enum:
            - debit
            - credit
          type: string
          x-struct: null
          x-validate: null
        reconciliation_id:
          description: Reconciliation ID
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        ref_id:
          description: ID of the referenced resource
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        ref_type:
          description: >-
            Resource `ref_id` points to: `in_document` and `out_document` are
            read through `/v2/documents/in` and `/v2/documents/out`, `in_refund`
            and `out_refund` through their `/refunds`, `transfer` through
            `/v2/documents/transfer`
          enum:
            - in_document
            - out_document
            - in_refund
            - out_refund
            - transfer
            - block_med
            - release_block_med
            - purchase
            - fee
            - ledger_batch
            - remuneration
            - cashback
            - judicial_block
            - cash_integration
            - boleto
            - receivable
          type: string
          x-struct: null
          x-validate: null
        transaction_date:
          description: Transaction date and time
          format: date-time
          type: string
          x-struct: null
          x-validate: null
        transaction_type:
          description: Transaction type
          enum:
            - regular
            - tax
            - fee
            - indirect_fee
            - direct_fee
            - specific
          type: string
          x-struct: null
          x-validate: null
        updated_at:
          description: Last update date and time
          format: date-time
          type: string
          x-struct: null
          x-validate: null
      title: V2 bank account transaction
      type: object
      x-struct: >-
        Elixir.TrioFoundationWeb.Schemas.Banking.V2.BankAccount.Transaction.TransactionData
      x-validate: null
  securitySchemes:
    authorization:
      scheme: basic
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.