Skip to main content
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>'
{
  "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"
    }
  }
}
Requires X-Api-Key and X-Api-Secret headers. See Authentication for details.
Use this endpoint to poll 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

​
X-Api-Key
string
header
required

Partner API key. Generated from Qash Dashboard → Settings → API Keys.

​
X-Api-Secret
string
header
required

Partner API secret. Shown once at creation — store it securely.

Path Parameters

​
userId
string<uuid>
required

UUID of the user, obtained from POST /users or GET /users.

Response

User details returned successfully.

​
success
boolean
required
Example:

true

​
data
object
required