> ## 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 Momos

> Retrieves a list of supported momos available in the specified country. Useful for rendering provider selection options during user payment setup or onboarding.



## OpenAPI

````yaml get /v1/momos
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/momos:
    get:
      tags:
        - Momo
      summary: List Momos
      description: >-
        Retrieves a list of supported momos available in the specified country.
        Useful for rendering provider selection options during user payment
        setup or onboarding.
      operationId: ListMomos
      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: country
          in: query
          description: >-
            ISO 3166-1 alpha-2 country code (e.g., 'SL', 'GH') to filter momos
            by region.
          required: true
          schema:
            type: string
            description: >-
              ISO 3166-1 alpha-2 country code (e.g., 'SL', 'GH') to filter momos
              by region.
        - 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/Momo'
                    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:
    Momo:
      title: Momo
      type: object
      properties:
        providerId:
          type: string
          description: The provider ID for the momo as assigned by Monime.
          example: m17
        name:
          type: string
          description: The name of the momo.
          example: Orange Money
        country:
          type: string
          description: The country of the momo.
          example: SL
        status:
          type: object
          properties:
            active:
              type: boolean
              description: Whether or not this momo is active within Monime.
          description: The status of the momo's operations within monime'.
        featureSet:
          type: object
          properties:
            payout:
              type: object
              properties:
                canPayTo:
                  type: boolean
                  description: Whether or not Monime can pay out to an account in the momo.
                schemes:
                  type: array
                  items:
                    type: string
                  description: The supported payout schemes of the momo.
                  nullable: true
                metadata:
                  type: object
                  additionalProperties:
                    type: string
                  description: Further metadata describing this momo's payout feature.
                  nullable: true
              description: The momo's payout feature information.
            payment:
              type: object
              properties:
                canPayFrom:
                  type: boolean
                  description: >-
                    Whether or not Monime can accept payment from an account in
                    the momo.
                schemes:
                  type: array
                  items:
                    type: string
                  description: The supported payment schemes of the momo.
                  nullable: true
                metadata:
                  type: object
                  additionalProperties:
                    type: string
                  description: Further metadata describing this momo's payment feature.
                  nullable: true
              description: The momo's payment feature information.
            kycVerification:
              type: object
              properties:
                canVerifyAccount:
                  type: boolean
                  description: >-
                    Whether or not Monime can verify an account's KYC' in the
                    momo.
                metadata:
                  type: object
                  additionalProperties:
                    type: string
                  description: >-
                    Further metadata describing this momo's KYC verification
                    feature.
                  nullable: true
              description: The momo's KYC verification feature information.
          description: The set of Monime features that the momo supports.'
        createTime:
          type: string
          description: The time the momo's support was added.
          format: date-time
        updateTime:
          type: string
          description: The last time the momo's support was updated.
          format: date-time
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: auth-scheme
      description: >-
        Bearer HTTP authentication specified with the header Authorization:
        Bearer <access_token>

````