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

# Verify a phone number

> Validates a mobile number through the public gateway, detects its country when the international format allows it, and returns the national wallet expected by SoleasPay providers.



## OpenAPI

````yaml en/api-reference/openapi.json POST /phone-numbers/verify
openapi: 3.1.0
info:
  title: Mysoleas API
  version: 3.0.0
  description: >-
    New Mysoleas architecture: business gateway, Mysoleas Identity Cloud, and
    SoleasPay ecosystem.
servers:
  - url: https://api.mysoleas.com
    description: Mysoleas gateway
  - url: https://account.mysoleas.com
    description: Mysoleas authentication
security:
  - spAuthToken: []
tags:
  - name: Identity Cloud
  - name: Plugin
  - name: Payment links
  - name: Subscriptions
  - name: Collections
  - name: Disbursements
  - name: Verification
  - name: Catalog
paths:
  /phone-numbers/verify:
    post:
      tags:
        - Verification
      summary: Verify a phone number
      description: >-
        Validates a mobile number through the public gateway, detects its
        country when the international format allows it, and returns the
        national wallet expected by SoleasPay providers.
      operationId: verifyPhoneNumber
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                wallet:
                  type: string
                  description: Customer phone number or wallet to verify.
                phone_number:
                  type: string
                  description: Alias of `wallet`.
                phone:
                  type: string
                  description: Alias of `wallet`.
                country:
                  type: string
                  description: >-
                    Expected country in ISO alpha-3, for example `CMR`. Required
                    for a national number or a calling code pasted without `+`
                    or `00`.
              oneOf:
                - required:
                    - wallet
                - required:
                    - phone_number
                - required:
                    - phone
            examples:
              national:
                summary: National number with country
                value:
                  wallet: '650020109'
                  country: CMR
              international:
                summary: Numero international auto-detectable
                value:
                  phone_number: '+237650020109'
              callingCodeWithoutPlus:
                summary: Calling code pasted with country
                value:
                  wallet: '237650020109'
                  country: CMR
      responses:
        '200':
          description: Valid number.
          content:
            application/json:
              example:
                code: 200
                success: true
                data:
                  valid: true
                  country:
                    alpha2: CM
                    alpha3: CMR
                    calling_code: '237'
                  number:
                    e164: '+237650020109'
                    international: +237 6 50 02 01 09
                    national: '650020109'
                    provider_wallet: '650020109'
                  type: MOBILE
                  operator: MTN Cameroon
                  supported_country: true
                  support_message: null
                locale: en
                message: Phone number verified.
        '400':
          description: Invalid number, missing country, or inconsistent country.
          content:
            application/json:
              examples:
                countryRequired:
                  value:
                    success: false
                    code: 400
                    message: phone_country_required
                invalidPhoneCountry:
                  value:
                    success: false
                    code: 400
                    message: invalid_phone_country
        '401':
          description: Missing or invalid API key.
      security:
        - merchantApiKey: []
components:
  securitySchemes:
    spAuthToken:
      type: apiKey
      in: header
      name: x-sp-auth-token
      description: >-
        JWT Bearer emis par Mysoleas Identity Cloud. Format: Bearer
        <access_token>.
    merchantApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        SoleasPay merchant API key. Used for public plugin endpoints or phone
        verification.

````