> ## 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.

# Get Counterparty Bank Account

> Show a counterparty bank account



## OpenAPI

````yaml v2/api-reference/openapi.json GET /v2/counterparties/{counterparty_id}/bank_accounts/{counterparty_bank_account_id}
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/counterparties/{counterparty_id}/bank_accounts/{counterparty_bank_account_id}:
    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:
        - Counterparties
      summary: Show counterparty bank account
      description: Show a counterparty bank account
      operationId: TrioFoundationWeb.V2.Counterparty.BankAccountController.show
      parameters:
        - description: Counterparty ID
          in: path
          name: counterparty_id
          required: true
          schema:
            $ref: '#/components/schemas/UUID'
        - description: Counterparty bank account ID
          in: path
          name: counterparty_bank_account_id
          required: true
          schema:
            $ref: '#/components/schemas/UUID'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_counterparty_bank_account_response'
          description: CounterpartyBankAccount
        '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
    V2_counterparty_bank_account_response:
      description: A counterparty bank account
      example:
        data:
          branch: '0001'
          digit: '1'
          id: 018df099-093e-cfd1-4500-4c9392eb5d8a
          inserted_at: '2024-10-17T13:32:59.374149Z'
          ispb: '12345678'
          number: '87654321'
          type: checking
          updated_at: '2024-10-17T13:32:59.374149Z'
      properties:
        data:
          $ref: '#/components/schemas/V2_counterparty_bank_account'
      title: V2 counterparty bank account response
      type: object
      x-struct: >-
        Elixir.TrioFoundationWeb.Schemas.Banking.V2.Counterparty.BankAccount.Response
      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_counterparty_bank_account:
      description: A counterparty bank account
      example:
        branch: '0001'
        digit: '1'
        id: 018df099-093e-cfd1-4500-4c9392eb5d8a
        inserted_at: '2024-10-17T13:32:59.374149Z'
        ispb: '12345678'
        number: '87654321'
        type: checking
        updated_at: '2024-10-17T13:32:59.374149Z'
      properties:
        branch:
          description: Branch
          type: string
          x-struct: null
          x-validate: null
        digit:
          description: Account digit
          type: string
          x-struct: null
          x-validate: null
        id:
          description: Counterparty bank account ID
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        inserted_at:
          description: >-
            Creation date and time. Null on show for a while after the bank
            account was found or created, which caches it without its dates
          format: date-time
          nullable: true
          type: string
          x-struct: null
          x-validate: null
        ispb:
          description: ISPB of the institution
          type: string
          x-struct: null
          x-validate: null
        number:
          description: Account number
          type: string
          x-struct: null
          x-validate: null
        type:
          description: Account type
          enum:
            - checking
            - payment
            - salary
            - savings
          type: string
          x-struct: null
          x-validate: null
        updated_at:
          description: >-
            Last update date and time. Null on show for a while after the bank
            account was found or created, which caches it without its dates
          format: date-time
          nullable: true
          type: string
          x-struct: null
          x-validate: null
      title: V2 counterparty bank account
      type: object
      x-struct: >-
        Elixir.TrioFoundationWeb.Schemas.Banking.V2.Counterparty.BankAccount.BankAccountData
      x-validate: null
  securitySchemes:
    authorization:
      scheme: basic
      type: http

````

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