GET /users/:ref
Get user details including KYC status, volume, and AML risk.
GET /users/:ref
Retrieve full details for a user by their partnerUserRef.
Request
curl -H "X-API-Key: mp2p_test_xxx" \
https://mexicop2p.org/api/v1/users/user_12345Response 200
{
"id": "cm3abc123",
"partnerUserRef": "user_12345",
"kycStatus": "APPROVED",
"kycTier": "BASIC",
"kycCompletedAt": "2025-06-14T10:00:00.000Z",
"orderCount": 5,
"totalVolumeMxn": 8625.00,
"monthlyVolumeMxn": 3450.00,
"amlRiskLevel": "LOW",
"isPep": false,
"isSanctioned": false,
"createdAt": "2025-06-01T09:00:00.000Z",
"updatedAt": "2025-06-15T12:00:00.000Z"
}Response fields
| Field | Type | Description |
|---|---|---|
id | string | Internal MexicoP2P user ID |
partnerUserRef | string | Your reference ID |
kycStatus | string | NOT_REQUIRED, PENDING, APPROVED, REJECTED |
kycTier | string | NONE, BASIC, FULL |
kycCompletedAt | string|null | When KYC was completed |
orderCount | number | Total orders |
totalVolumeMxn | number | Lifetime volume in MXN |
monthlyVolumeMxn | number | Current month's volume |
amlRiskLevel | string|null | LOW, MEDIUM, HIGH, or null |
isPep | boolean | Politically exposed person flag |
isSanctioned | boolean | Sanctions list match |
createdAt | string | Registration timestamp |
updatedAt | string | Last update timestamp |
Errors
| Code | HTTP | When |
|---|---|---|
NOT_FOUND | 404 | User doesn't exist for this partner |