Create a new KYC session

POST /kyc/session/create

Description

The method creates a new session for KYC (user identification) verification. JWT token is required in the header for access.

Request format

HTTP method: POST
URL: /kyc/session/create
Content Type: application/json
Authorization: required

Query Parameters

Parameter	Type	Passed In	Required	Description
token	string	Header	✅	User’s JWT token

Request Body (JSON)

Field	Type	Required	Description
token	string	✅	User’s JWT token
schemaId	string	✅	Validation schema ID
captcha	string	❌	Captcha (if required)

Example Request (cURL)

curl -X POST "https://api.neuro-vision.ru/v1/kyc/session/create" 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer jwt.temporary.token" 
  -d '{
    "token": "jwt.temporary.token",
    "schemaId": "schema-001",
    "captcha": "captcha-value"
  }'

Example Answers

Success (200 OK)

{
  "sessionId": "00000000-0000-0000-0000-000000000000",
  "clientId": "null",
  "status": "idle",
  "spent": 0,
  "results": [
    {
      "status": "idle",
      "type": "document",
      "spent": 0,
      "errors": [],
      "checks": []
    }
  ],
  "createdAt": "2025-05-21T08:14:20.959Z",
  "isClientNew": true
}

Error (400 Bad Request)

{
  "message": "invalid schema",
  "status": "error"
}