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

# List Countries

> Retrieves a list of supported countries available in the Monime platform. Useful for onboarding flows, address validation, or region-based payment configurations.



## OpenAPI

````yaml get /v1/countries
openapi: 3.0.3
info:
  title: Monime API
  description: Monime REST API. Please visit https://docs.momime.io/api for more details.
  termsOfService: https://monime.io/legal/terms-of-service
  contact:
    name: Monime Developers
    url: https://github.com/monimesl
    email: dev@monime.io
  version: v1
servers:
  - url: https://api.monime.io/
security:
  - bearerAuth: []
paths:
  /v1/countries:
    get:
      tags:
        - Country
      summary: List Countries
      description: >-
        Retrieves a list of supported countries available in the Monime
        platform. Useful for onboarding flows, address validation, or
        region-based payment configurations.
      operationId: ListCountries
      parameters:
        - name: limit
          in: query
          description: >-
            Maximum number of items to return in a single page. Must be between
            1 and 50. Defaults to 10 if not specified.
          schema:
            maximum: 50
            minimum: 1
            type: integer
            description: >-
              Maximum number of items to return in a single page. Must be
              between 1 and 50. Defaults to 10 if not specified.
            default: 10
        - name: after
          in: query
          description: >-
            Pagination cursor for fetching the next page of results. Set this to
            the 'next' cursor value from a previous response to continue
            paginating forward.
          schema:
            maxLength: 2000
            type: string
            description: >-
              Pagination cursor for fetching the next page of results. Set this
              to the 'next' cursor value from a previous response to continue
              paginating forward.
            nullable: true
        - name: Monime-Version
          in: header
          description: Specifies which version of the Monime API will handle this request.
          schema:
            enum:
              - caph.2025-08-23
              - caph.2025-06-20
            type: string
            description: >-
              Specifies which version of the Monime API will handle this
              request.
            nullable: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: >-
                      Represents the status of the query operation, confirming
                      if it was successful. This field is always true
                  messages:
                    type: array
                    items: {}
                    description: >-
                      Contains a list of messages providing relevant information
                      or feedback related to the query or operation
                  result:
                    type: array
                    items:
                      $ref: '#/components/schemas/Country'
                    description: The list of items in the response
                    nullable: true
                  pagination:
                    type: object
                    properties:
                      count:
                        type: integer
                        description: Number of items returned in the current page.
                      next:
                        type: string
                        description: >-
                          Cursor pointing to the next page of results. Use this
                          value as the 'after' query parameter in your next
                          request to fetch the following page. If null, you have
                          reached the end of the result set.
                        nullable: true
                    description: The pagination info associated with the response
components:
  schemas:
    Country:
      title: Country
      type: object
      properties:
        code:
          type: string
          description: The ISO 3166-1 alpha-2 country code.
          example: SL
        name:
          type: string
          description: The name of the country.
          example: Sierra Leone
        currency:
          type: object
          properties:
            code:
              type: string
              description: >-
                The [3-letter](https://en.wikipedia.org/wiki/ISO_4217) ISO
                currency code.
              example: SLE
            unit:
              type: string
              description: The subunit for the currency.
              example: cent
            unitLength:
              type: integer
              description: The unit length for the currency's subunit.
              example: 2
          description: The default currency object of the country.
        supportedCurrencies:
          type: array
          items:
            type: string
          description: >-
            The list supported currency codes in ISO 4217 format in that
            country. It includes the default currency's code.
          nullable: true
          example:
            - SLE
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: auth-scheme
      description: >-
        Bearer HTTP authentication specified with the header Authorization:
        Bearer <access_token>

````