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

# Retrieve Lipa Namba Providers

> Returns the list of Lipa Namba providers.



## OpenAPI

````yaml api-reference/disbursement/lipa-namba-payout/openapi.json GET /payouts/lipa-namba-providers
openapi: 3.0.1
info:
  title: CORE API OpenAPI Specification
  description: This is the API documentation for the ClickPesa CORE API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.clickpesa.com/third-parties
security:
  - bearerAuth: []
paths:
  /payouts/lipa-namba-providers:
    get:
      tags:
        - Payouts
        - Lipa Namba
      description: Returns the list of Lipa Namba providers.
      responses:
        '200':
          description: Lipa Namba providers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LipaNambaProvidersResponse'
        '400':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '401':
          description: Invalid or Expired Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
components:
  schemas:
    LipaNambaProvidersResponse:
      type: array
      items:
        type: object
        properties:
          name:
            type: string
            description: Display name of the provider
            example: Vodacom M-Pesa
          providerCode:
            type: string
            description: Pass as `providerCode` when using `lipaNamba`
            example: '503'
    ValidationError:
      type: object
      properties:
        message:
          type: string
          enum:
            - Valid Client ID is required
            - >-
              Application has no access to PAYOUT API feature. Enable it on your
              application.
            - >-
              Invalid Order Reference, should only contain alphanumeric
              characters and cannot be blank
            - lipaNamba or qrCode is required
            - Provide either lipaNamba or qrCode, not both
            - providerCode is required when lipaNamba is provided
            - >-
              Lipa Namba beneficiary name could not be resolved. Preview is
              required before payout.
            - 'Insufficient balance: available balance is {balance} TZS'
            - >-
              Payout request is already in progress, please retry after
              {remaining time} seconds
          example: lipaNamba or qrCode is required
    UnauthorizedError:
      type: object
      properties:
        message:
          type: string
          description: Unauthorized Error
          example: Unauthorized
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Authorization header containing the JWT access token returned from the
        generate token endpoint. The token already includes the Bearer prefix.
        Example: `Authorization: Bearer eyJhbGciOi...`
      bearerFormat: JWT

````