Skip to main content
POST
/
api
/
v1
/
partner
/
kyc
curl --request POST \
  --url https://api.qash.ai/api/v1/partner/kyc \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Api-Secret: <api-key>' \
  --data '
{
  "userId": "03384ada-a9c5-4c2e-a1bd-a13629ba060c",
  "firstName": "Juan",
  "lastName": "Pérez",
  "email": "usuario@empresa.com"
}
'
{
  "success": true,
  "verificationUrl": "https://inquiry.withpersona.com/verify?inquiry-id=inq_A3VPwfoLJtprzJxREEeq3kmz6MyYyw",
  "inquiryId": "inq_A3VPwfoLJtprzJxREEeq3kmz6MyYyw"
}
Requires X-Api-Key and X-Api-Secret headers. See Authentication for details.
Redirect the user to the returned verificationUrl to complete their identity check through Persona. Once completed, Persona notifies Qash automatically and the user’s status transitions to active — no polling or webhook required on your end.
Returns 409 if KYC has already been initiated for this user. Call Get user to check current status before calling this endpoint.

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.

Body

application/json

KYC initiation payload.

​
userId
string<uuid>
required

ID of the user to verify, obtained from POST /users.

Example:

"03384ada-a9c5-4c2e-a1bd-a13629ba060c"

​
firstName
string
required

User's first name.

Example:

"Juan"

​
lastName
string
required

User's last name.

Example:

"Pérez"

​
email
string<email>
required

User's email address.

Example:

"usuario@empresa.com"

​
phone
string

Phone number in international format.

Example:

"+573001234567"

​
birthDate
string<date>

Date of birth in YYYY-MM-DD format.

Example:

"1990-04-15"

Response

KYC initiated successfully.

​
success
boolean
required
Example:

true

​
verificationUrl
string<uri>
required

URL to redirect the user to for completing identity verification via Persona.

Example:

"https://inquiry.withpersona.com/verify?inquiry-id=inq_A3VPwfoLJtprzJxREEeq3kmz6MyYyw"

​
inquiryId
string
required

Persona inquiry ID for tracking the verification.

Example:

"inq_A3VPwfoLJtprzJxREEeq3kmz6MyYyw"