Skip to main content
GET
/
api
/
v3
/
customer
/
mobile-money
/
phone
/
{phone_number}
Get a mobile money customer by Phone
curl --request GET \
  --url https://preview.kotanipay.com/api/v3/customer/mobile-money/phone/{phone_number} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Customer fetched successfully.",
  "data": {
    "phone_number": "<string>",
    "country_code": "GH, KE, NG (or ISO-3: GHA, KEN, NGA)",
    "id": "<string>",
    "network": "MPESA or MTN or AIRTEL or VODAFONE",
    "customer_key": "<string>",
    "account_name": "<string>",
    "integrator": "<string>",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-01-01",
    "id_number": "123456789",
    "id_type": "NATIONAL_ID",
    "image": "<string>",
    "email": "john.doe@example.com"
  }
}

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.

An integrator can use this endpoint to get the customer who will be either receiving or sending money using mobile money by passing phone number.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
phone_number
string
required

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Customer fetched successfully."

​
data
object