Skip to main content
POST
/
sessions
curl -X POST \
  "https://verilock.io/api/v1/sessions" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
  "type": "kyc",
  "reference_id": "usr_12345",
  "steps": ["document", "selfie", "face_match", "liveness", "aml"],
  "redirect_url": "https://example.com/kyc/complete",
  "webhook_url": "https://example.com/webhooks/kyc",
  "applicant": {
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "jean.dupont@example.com",
    "date_of_birth": "1990-05-15",
    "nationality": "FR"
  }
}'
{
  "id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "kyc",
  "status": "created",
  "reference_id": "usr_12345",
  "steps": ["document", "selfie", "face_match", "liveness", "aml"],
  "applicant": {
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "jean.dupont@example.com",
    "date_of_birth": "1990-05-15",
    "nationality": "FR"
  },
  "hosted_url": "https://verilock.io/verify/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-03-15T10:30:00Z"
}

Request Body Parameters

type
string
required
Verification type. Currently only "kyc"
reference_id
string
Your internal reference ID for this session
steps
array
required
Verification steps to perform: "document", "selfie", "face_match", "liveness", "aml"
redirect_url
string
URL to redirect the applicant after completing the hosted flow
webhook_url
string
URL to receive webhook notifications for status changes
applicant
object
required
Applicant information
curl -X POST \
  "https://verilock.io/api/v1/sessions" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
  "type": "kyc",
  "reference_id": "usr_12345",
  "steps": ["document", "selfie", "face_match", "liveness", "aml"],
  "redirect_url": "https://example.com/kyc/complete",
  "webhook_url": "https://example.com/webhooks/kyc",
  "applicant": {
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "jean.dupont@example.com",
    "date_of_birth": "1990-05-15",
    "nationality": "FR"
  }
}'
{
  "id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "kyc",
  "status": "created",
  "reference_id": "usr_12345",
  "steps": ["document", "selfie", "face_match", "liveness", "aml"],
  "applicant": {
    "first_name": "Jean",
    "last_name": "Dupont",
    "email": "jean.dupont@example.com",
    "date_of_birth": "1990-05-15",
    "nationality": "FR"
  },
  "hosted_url": "https://verilock.io/verify/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-03-15T10:30:00Z"
}