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

# Get Supported Countries

> Returns a list of all supported countries with their configurations. Supports filtering by service type, currency, country code, and active status. Data is aggregated from the Provider Registry for real-time accuracy. The isEnabled flag indicates whether the authenticated integrator has this service enabled and providers attached.

Get a list of all supported countries with their configurations, filterable by service type, currency, and status.


## OpenAPI

````yaml GET /api/v3/customer/support/countries
openapi: 3.0.0
info:
  title: KOTANI PAY API PLATFORM
  description: ''
  version: '3.0'
  contact: {}
servers:
  - url: https://preview.kotanipay.com
security: []
tags: []
paths:
  /api/v3/customer/support/countries:
    get:
      tags:
        - CUSTOMER - COUNTRY SUPPORT
      summary: Get supported countries
      description: >-
        Returns a list of all supported countries with their configurations.
        Supports filtering by service type, currency, country code, and active
        status. Data is aggregated from the Provider Registry for real-time
        accuracy. The isEnabled flag indicates whether the authenticated
        integrator has this service enabled and providers attached.
      operationId: CountrySupportController_getSupportedCountries_api/v3
      parameters:
        - name: serviceType
          required: false
          in: query
          description: Filter by service type
          schema:
            example: WITHDRAW
            type: string
            enum:
              - DEPOSIT
              - CARD_DEPOSIT
              - WITHDRAW
              - DETAILS
        - name: currency
          required: false
          in: query
          description: Filter by currency
          schema:
            example: KES
            type: string
            enum:
              - KES
              - GHS
              - NGN
              - ZAR
              - ZAR
              - USD
              - XOF
              - ZMW
              - XAF
              - SLE
              - CDF
              - TZS
              - UGX
              - EGP
              - MWK
              - RWF
              - ETB
              - MZN
              - LSL
              - GNF
              - USDT
              - BTC
              - ETH
              - USDC
        - name: countryCode
          required: false
          in: query
          description: Filter by country code (e.g., KE, NG, GH)
          schema:
            example: KE
            type: string
        - name: isActive
          required: false
          in: query
          description: Filter by active status
          schema:
            type: boolean
            example: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Countries retrieved successfully
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CountrySupportResponseDto'
        '400':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Invalid query parameters
                  data:
                    type: object
                    example: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                properties:
                  success:
                    type: boolean
                    example: false
                  message:
                    type: string
                    example: Unauthorized
                  data:
                    type: object
                    example: {}
      security:
        - JWT: []
components:
  schemas:
    CountrySupportResponseDto:
      type: object
      properties:
        countryCode:
          type: string
          description: ISO 3166-1 alpha-2 country code
          example: KE
        name:
          type: string
          description: Full country name
          example: Kenya
        iso3Code:
          type: string
          description: ISO 3166-1 alpha-3 country code (optional)
          example: KEN
        currency:
          type: string
          description: Currency code
          example: KES
        serviceType:
          type: string
          description: Service type
          example: WITHDRAW
        isActive:
          type: boolean
          description: Is the country active for this service
          example: true
        isEnabled:
          type: boolean
          description: Is this service enabled for the authenticated integrator
          example: true
        requiresNetwork:
          type: boolean
          description: Requires network selection for mobile money
          example: false
        requiresAccountName:
          type: boolean
          description: Requires account name for mobile money
          example: false
        supportedNetworks:
          description: Supported mobile money networks
          example:
            - MTN
            - VODAFONE
            - AIRTEL
          type: array
          items:
            type: string
        availableNetworks:
          description: Available networks for this country
          example:
            - MPESA
            - AIRTEL
          type: array
          items:
            type: string
      required:
        - countryCode
        - name
        - currency
        - serviceType
        - isActive
        - isEnabled
        - requiresNetwork
        - requiresAccountName
  securitySchemes:
    JWT:
      scheme: bearer
      bearerFormat: JWT
      type: http

````