---
updatedAt: 2025-09-18T20:59:40.000Z
agentTools:
  projectIndex: https://kotani-pay.readme.io/llms.txt
---

# Get a mobile money customer by customer key

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.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/api/v3/customer/mobile-money/{customer_key}": {
      "get": {
        "operationId": "MobileMoneyCustomerController_getCustomerDetails",
        "summary": "Get a mobile money customer by customer key",
        "description": "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.",
        "parameters": [
          {
            "name": "customer_key",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    },
                    "message": {
                      "type": "string",
                      "example": "Customer fetched successfully."
                    },
                    "data": {
                      "type": "object",
                      "$ref": "#/components/schemas/MobileMoneyCustomerDto"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": ""
          },
          "404": {
            "description": ""
          }
        },
        "tags": [
          "CUSTOMER - MOBILE MONEY"
        ],
        "security": [
          {
            "JWT": []
          }
        ]
      }
    }
  },
  "info": {
    "title": "KOTANI PAY API PLATFORM",
    "description": "",
    "version": "3.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://sandbox-api.kotanipay.io",
      "description": "Sandbox"
    }
  ],
  "components": {
    "securitySchemes": {
      "JWT": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "MobileMoneyCustomerDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "phone_number": {
            "type": "string"
          },
          "country_code": {
            "type": "string",
            "enum": [
              "GHA",
              "NG",
              "KE",
              "ZA",
              "CIV",
              "ZM",
              "CMR",
              "COD",
              "SEN",
              "TZ",
              "MWI",
              "UG",
              "EG",
              "RW",
              "US"
            ],
            "example": "GHA or KE"
          },
          "network": {
            "type": "string",
            "enum": [
              "MTN",
              "AIRTEL",
              "VODAFONE",
              "TIGO",
              "ORANGE",
              "NOT_SUPPORTED",
              "ZAMTEL",
              "MPESA",
              "CHECKOUT",
              "BKTRX",
              "CRDTRX",
              "MOOV",
              "TMONEY",
              "FREE",
              "EXPRESSO",
              "HALOPESA",
              "VODACOM",
              "TNM"
            ],
            "example": "MPESA or MTN or AIRTEL or VODAFONE"
          },
          "customer_key": {
            "type": "string"
          },
          "account_name": {
            "type": "string"
          },
          "integrator": {
            "type": "string"
          }
        },
        "required": [
          "phone_number",
          "country_code"
        ]
      }
    }
  }
}
```