Get user profile
curl --request GET \
--url https://api.example.com/api/v1/user/profileconst options = {method: 'GET'};
fetch('https://api.example.com/api/v1/user/profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/api/v1/user/profile"
response = requests.get(url)
print(response.text)User profile
Get user profile
Retrieve the personal profile of the authenticated user.
GET
/
api
/
v1
/
user
/
profile
Get user profile
curl --request GET \
--url https://api.example.com/api/v1/user/profileconst options = {method: 'GET'};
fetch('https://api.example.com/api/v1/user/profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/api/v1/user/profile"
response = requests.get(url)
print(response.text)Requires
X-Api-Key and X-Api-Secret headers. Pass userId as a query parameter — no JWT required. See Authentication for details.Request
GET /api/v1/user/profile?userId=a1b2c3d4-e5f6-7890-abcd-ef1234567890
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
userId | string | Yes | Qash user ID |
Response
200 OK{
"success": true,
"data": {
"profile": {
"id": "prof_abc123",
"userId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"firstName": "Juan",
"lastName": "García",
"middleName": null,
"fullName": "Juan García",
"dateOfBirth": "1990-05-15T00:00:00.000Z",
"nationality": "MX",
"gender": "male",
"governmentIdType": "passport",
"governmentIdNumber": "A1234567",
"governmentIdCountry": "MX",
"governmentIdExpiry": null,
"addressLine1": "Av. Insurgentes Sur 1234",
"addressLine2": null,
"city": "Ciudad de México",
"stateProvince": "CDMX",
"postalCode": "06600",
"addressCountry": "MX",
"occupation": "engineer",
"annualSalary": "50000-100000",
"accountPurpose": "personal_savings",
"expectedMonthlyVolume": "5000-10000",
"isPep": false,
"isSanctioned": false,
"usCitizen": false,
"acceptedTerms": "2026-06-01T00:00:00.000Z",
"createdAt": "2026-06-01T00:00:00.000Z",
"updatedAt": "2026-06-01T00:00:00.000Z"
}
}
}
Errors
| HTTP status | Error | Cause |
|---|---|---|
400 | Missing userId in request body or query params | userId query param missing |
401 | Invalid partner credentials | Wrong X-Api-Key or X-Api-Secret |
403 | User does not belong to this partner | userId belongs to a different partner |
404 | PersonalProfile not found: <userId> | No profile has been created for this user — call POST /user/profile first |
⌘I