Fetch Customer Details
Retrieves comprehensive customer profile including card details, wallet balances, KYC status, preferences, and account information.
Search Options
You can search by one or more of:
- Mobile number
- PAN number
- Date of birth
- Entity ID
- Kit number
- CIF number
Response Includes
- Customer personal details (name, DOB, gender, email)
- All card accounts with status, kit number, masked card number
- Wallet details with currency and account IDs
- KYC status and verification method
- Card preferences (ATM, POS, E-com limits)
- Trip history (for forex customers)
- Bank account details
- Product information
Authorization
bearerAuth tenantId JWT Bearer token from the Authentication API
In: header
Your unique tenant identifier assigned during onboarding
In: header
Header Parameters
Your unique tenant identifier
Request Body
application/json
PAN number
PAN number (alternate field)
Date of birth (format: YYYY-MM-DD)
Customer entity ID
Card kit number
CIF number
Multiple kit numbers
Response Body
application/json
application/json
application/json
curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/customer/v1/customers/fetch" \ -H "X-TENANT-ID: ACME_CORP" \ -H "Content-Type: application/json" \ -d '{ "mobile": { "value": "9876543210", "countryCode": 91 }, "pan": "SIYPS9021Y", "dob": "2001-09-04" }'{
"result": {
"id": "68d4df9a218558bad8c17354",
"firstName": "John",
"lastName": "Doe",
"email": "john@example.com",
"pan": "ABCDE1234F",
"dob": "1990-01-15",
"gender": "MALE",
"customerId": "9932482",
"accounts": [
{
"entityId": "617713338570000051250925",
"card": {
"kit": "570000052",
"expiry": "10/27",
"nameOnCard": "John Doe",
"cardNumber": "876541XXXXXX0682",
"kitStatus": {
"status": "ACTIVE",
"lastUpdated": "2025-09-25T06:53:54Z"
}
},
"wallets": [
{
"accountId": "17587813365590055",
"wallet": {
"walletName": "GPRPROG001",
"walletType": "GPR",
"walletBaseCurrency": {
"currencyCodeISO": "INR",
"currencyCodeNumeric": 356
}
}
}
],
"product": {
"productId": "HoV35EWlsS",
"productName": "COOLGPRONLY001",
"type": "GPR"
},
"kycStatus": {
"status": "MINKYC",
"kycVerificationMethod": "Bank KYC"
}
}
],
"customerType": "NTB",
"mobile": {
"value": "9876543210",
"countryCode": 91
}
},
"pagination": null
}{
"type": "https://www.m2pfintech.com/problem/problem-with-message",
"title": "Bad Request",
"status": 400,
"detail": "Unable to convert http message",
"message": "error.http.400"
}{
"type": "https://www.m2pfintech.com/problem/problem-with-message",
"title": "Customer does not exists for id",
"status": 409,
"detail": "Customer does not exists for given input",
"message": "error.business",
"businessCode": "PPCUST_002"
}Fetch Customer by UniqueId or EntityId POST
Retrieves customer details using either the **customer unique ID** or the **entity ID**. Returns the same comprehensive profile as the Fetch Customer endpoint. ### Use Case - When you have the entity ID from a webhook or transaction response - Quick lookup without needing mobile/PAN details
Fetch Customer Details by Search Criteria POST
Searches for and retrieves customer details based on a flexible search criteria. This is the primary customer lookup API that supports searching by mobile number, kit number, entity ID, PAN, email, and other identifiers. ### When to Use - **Customer Support**: Look up a customer using whatever identifier they provide - **Pre-Transaction Validation**: Verify customer existence before initiating operations - **Profile Display**: Fetch customer details to display in your app or portal ### Response Returns comprehensive customer details including: - Personal information (name, DOB, gender, email, mobile) - KYC details and status - Card details (kit number, card status, product type) - Account/wallet information - Address details ### Important Notes - The response structure includes nested card and wallet details - For customers with multiple cards, all cards are included in the response - PAN and Aadhaar numbers are masked in the response for security