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

# List local bank codes

> Retrieve the list of supported bank codes for local transfers. Currently only Kenya (KE) is supported. Use bank codes from this endpoint when initiating PesaLink transfers or account name validation.



## OpenAPI

````yaml api-reference/openapi.json get /v1/local-bank-codes
openapi: 3.1.0
info:
  title: Fingo Pay API
  description: >-
    Fingo Pay's unified payments API for M-Pesa C2B (STK Push), B2C
    disbursements, B2B transfers, bank transfers, account balances, and
    transactions.
  version: 1.0.0
servers:
  - url: https://api.fingopay.io
security:
  - bearerAuth: []
tags:
  - name: Payments
    description: Receive payments from customers
  - name: Payouts
    description: Send payments to recipients
  - name: Accounts
    description: Account balances and management
  - name: Transactions
    description: Transaction history and lookup
  - name: Verification
    description: Pre-transaction verification and lookup
  - name: Webhooks
    description: Webhook event notifications
paths:
  /v1/local-bank-codes:
    get:
      tags:
        - Verification
      summary: List local bank codes
      description: >-
        Retrieve the list of supported bank codes for local transfers. Currently
        only Kenya (KE) is supported. Use bank codes from this endpoint when
        initiating PesaLink transfers or account name validation.
      operationId: getLocalBankCodes
      parameters:
        - name: country
          in: query
          required: true
          description: >-
            Country code (ISO 3166-1 alpha-2). Currently only `KE` (Kenya) is
            supported. Other country codes will return a not-available error.
          schema:
            type: string
            enum:
              - KE
            example: KE
      responses:
        '200':
          description: Bank codes fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankCodesResponse'
        '400':
          $ref: '#/components/responses/ErrorResponse'
        '401':
          $ref: '#/components/responses/ErrorResponse'
components:
  schemas:
    BankCodesResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        message:
          type: string
          example: Bank codes fetched
        data:
          type: array
          items:
            $ref: '#/components/schemas/BankCode'
      required:
        - status
        - message
        - data
    BankCode:
      type: object
      properties:
        bankCode:
          type: string
          example: '07000'
          description: Unique bank identifier code
        bankName:
          type: string
          example: Equity Bank
          description: Full name of the bank
      required:
        - bankCode
        - bankName
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - invalid_request_error
                - authentication_error
                - rate_limit_error
                - api_error
                - idempotency_error
                - not_found_error
                - conflict_error
              description: Error category
            code:
              type: string
              enum:
                - missing_parameter
                - invalid_parameter
                - unauthorized
                - forbidden
                - too_many_requests
                - internal_error
                - duplicate
                - resource_not_found
                - missing_header
                - validation_error
              description: Specific error code
            message:
              type: string
              description: Human-readable error message
            param:
              type:
                - string
                - 'null'
              description: The parameter that caused the error, if applicable
            requestId:
              type: string
              description: Request ID for support reference
          required:
            - type
            - code
            - message
      required:
        - error
  responses:
    ErrorResponse:
      description: Error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Use your API key as a Bearer token. Example: Authorization: Bearer
        sk_live_...

````