Skip to main content
GET
/
api
/
v3
/
customer
/
mobile-money
/
{customer_key}
Get a mobile money customer by customer key
curl --request GET \
  --url https://sandbox-api.kotanipay.com/api/v3/customer/mobile-money/{customer_key} \
  --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": "[email protected]"
  }
}
An integrator can use this endpoint to get the customer who will be either receiving or sending money using mobile money by passing customer key.

Authorizations

Authorization
string
header
required

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

Path Parameters

customer_key
string
required

Response

success
boolean
Example:

true

message
string
Example:

"Customer fetched successfully."

data
object