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

# List a Payee's Bank Accounts

> Return every active bank account that has been saved for this payee. Revoked (deleted) accounts are not included. Each entry shows only the last four digits of the account and routing numbers.



## OpenAPI

````yaml GET /v1/platform/payees/bank-accounts/{payee_id}
openapi: 3.1.0
info:
  title: Finogate Platform API v1
  version: 0.1.0
servers:
  - url: https://api-sandbox.finogates.com
    description: Sandbox
  - url: https://api.finogates.com
    description: Production
security: []
tags:
  - name: auth
  - name: users
  - name: payees
  - name: verification
  - name: bank accounts
  - name: card processing
  - name: digital-assets
  - name: international
  - name: fees
  - name: onboarding
  - name: pending-applications
  - name: wallets
  - name: payments
  - name: document mailing
  - name: merchant onboarding
  - name: catalog
  - name: webhooks
  - name: screening
  - name: Platform - File Scanning
  - name: phone-numbers
  - name: sms
  - name: calls
  - name: listings
  - name: Card Transfers
  - name: embed-tokens
paths:
  /v1/platform/payees/bank-accounts/{payee_id}:
    get:
      tags:
        - payees
      summary: List a Payee's Bank Accounts
      description: >-
        Return every active bank account that has been saved for this payee.
        Revoked (deleted) accounts are not included. Each entry shows only the
        last four digits of the account and routing numbers.
      operationId: list_bank_accounts_v1_platform_payees_bank_accounts__payee_id__get
      parameters:
        - name: payee_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Payee Id
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            description: >-
              Optional. The unique ID of the user who owns this payee. Omit to
              look the payee up by its ID within your tenant.
            examples:
              - b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4
            title: User Id
          description: >-
            Optional. The unique ID of the user who owns this payee. Omit to
            look the payee up by its ID within your tenant.
      responses:
        '200':
          description: The payee's active bank accounts (sensitive numbers masked).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResponse_list_PayeeBankAccountRead__'
              example:
                status_code: 200
                data:
                  - id: f1e2d3c4-b5a6-7890-1234-567890abcdef
                    payee_id: d4e5f6a7-b8c9-0123-4567-890abcdef012
                    nickname: Acme — Operating
                    account_holder_name: Acme Supplier LLC
                    bank_name: Example Bank
                    bank_country: US
                    currency: USD
                    rail_code: ach
                    account_type: checking
                    account_last4: '6789'
                    routing_last4: '0021'
                    status: active
                    created_at: '2025-06-10T18:12:00.000Z'
                    updated_at: '2025-06-10T18:12:00.000Z'
                  - id: 0a1b2c3d-4e5f-6789-abcd-ef0123456789
                    payee_id: d4e5f6a7-b8c9-0123-4567-890abcdef012
                    nickname: Acme — India payouts
                    account_holder_name: Acme Supplier Pvt Ltd
                    bank_name: State Bank of India
                    bank_country: IN
                    currency: INR
                    rail_code: wire
                    account_last4: '4321'
                    bank_branch: SBIN0001234
                    bank_document: ABCDE1234F
                    payout_branch_id: 4821
                    status: active
                    created_at: '2025-06-11T08:30:00.000Z'
                    updated_at: '2025-06-11T08:30:00.000Z'
                row_count: 2
                query_generated_time: 1712847600000
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - _AuthenticatedBearer: []
components:
  schemas:
    ListResponse_list_PayeeBankAccountRead__:
      properties:
        status_code:
          type: integer
          title: Status Code
          description: HTTP status code for the response.
        data:
          items:
            $ref: '#/components/schemas/PayeeBankAccountRead'
          type: array
          title: Data
          description: Payload or error details.
        query_generated_time:
          type: integer
          title: Query Generated Time
          description: >-
            UTC timestamp (milliseconds since epoch) when response was
            generated.
        row_count:
          type: integer
          minimum: 0
          title: Row Count
          description: Total rows matching the request filters (not just this page).
        limit:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Limit
          description: >-
            Page size used for this response. Null for cursor-paginated
            endpoints.
        current_page:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Current Page
          description: >-
            1-indexed page number for this response. Null for cursor-paginated
            endpoints.
        total_page_number:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Total Page Number
          description: >-
            Total number of pages given the current limit. Null for
            cursor-paginated endpoints.
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: Cursor for the next page, if available.
      type: object
      required:
        - status_code
        - data
        - query_generated_time
        - row_count
      title: ListResponse[list[PayeeBankAccountRead]]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PayeeBankAccountRead:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        payee_id:
          type: string
          format: uuid
          title: Payee Id
        nickname:
          anyOf:
            - type: string
            - type: 'null'
          title: Nickname
        account_holder_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Holder Name
        bank_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Bank Name
        bank_country:
          anyOf:
            - type: string
            - type: 'null'
          title: Bank Country
        currency:
          anyOf:
            - type: string
            - type: 'null'
          title: Currency
        rail_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Rail Code
        account_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Type
        account_last4:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Last4
        routing_last4:
          anyOf:
            - type: string
            - type: 'null'
          title: Routing Last4
        routing_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Routing Number
        swift_bic:
          anyOf:
            - type: string
            - type: 'null'
          title: Swift Bic
        iban_last4:
          anyOf:
            - type: string
            - type: 'null'
          title: Iban Last4
        bank_branch:
          anyOf:
            - type: string
            - type: 'null'
          title: Bank Branch
        bank_document:
          anyOf:
            - type: string
            - type: 'null'
          title: Bank Document
        payout_branch_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Payout Branch Id
        status:
          type: string
          title: Status
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created At
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
      type: object
      required:
        - id
        - payee_id
        - status
      title: PayeeBankAccountRead
      description: Bank account returned by the API — last-four digits only.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    _AuthenticatedBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: /v1/platform/auth/token

````