Get user
curl --request GET \
--url https://api.qash.ai/api/v1/partner/users/{userId} \
--header 'X-Api-Key: <api-key>' \
--header 'X-Api-Secret: <api-key>'const options = {
method: 'GET',
headers: {'X-Api-Key': '<api-key>', 'X-Api-Secret': '<api-key>'}
};
fetch('https://api.qash.ai/api/v1/partner/users/{userId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.qash.ai/api/v1/partner/users/{userId}"
headers = {
"X-Api-Key": "<api-key>",
"X-Api-Secret": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"user": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "user@example.com",
"status": "active",
"countryCode": "CO",
"phone": "+573001234567",
"preferredLanguage": "es",
"createdAt": "2026-05-27T10:00:00.000Z"
}
}
}{
"success": false,
"error": "Invalid partner credentials"
}{
"success": false,
"error": "User not found"
}{
"success": false,
"error": "Failed to retrieve user"
}Users
Get user
Retrieve full details of a specific end-user.
GET
/
api
/
v1
/
partner
/
users
/
{userId}
Get user
curl --request GET \
--url https://api.qash.ai/api/v1/partner/users/{userId} \
--header 'X-Api-Key: <api-key>' \
--header 'X-Api-Secret: <api-key>'const options = {
method: 'GET',
headers: {'X-Api-Key': '<api-key>', 'X-Api-Secret': '<api-key>'}
};
fetch('https://api.qash.ai/api/v1/partner/users/{userId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.qash.ai/api/v1/partner/users/{userId}"
headers = {
"X-Api-Key": "<api-key>",
"X-Api-Secret": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text){
"success": true,
"data": {
"user": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "user@example.com",
"status": "active",
"countryCode": "CO",
"phone": "+573001234567",
"preferredLanguage": "es",
"createdAt": "2026-05-27T10:00:00.000Z"
}
}
}{
"success": false,
"error": "Invalid partner credentials"
}{
"success": false,
"error": "User not found"
}{
"success": false,
"error": "Failed to retrieve user"
}Requires
X-Api-Key and X-Api-Secret headers. See Authentication for details.status after calling Start KYC to confirm when a user transitions to active.
Returns 404 both when the user doesn’t exist and when they belong to a different partner — isolation between partners is strict.Authorizations
Partner API key. Generated from Qash Dashboard → Settings → API Keys.
Partner API secret. Shown once at creation — store it securely.
Path Parameters
UUID of the user, obtained from POST /users or GET /users.
Response
User details returned successfully.
Example:
true
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Current lifecycle status of the user.
Available options:
pending, active, suspended, banned Example:
"CO"
Example:
"es"
Present only if registered.
Example:
"+573001234567"