Get a list of all KYC sessions

POST /kyc/sessions

Description

The method returns all user KYC sessions with their statuses and results. A JWT token is required in the header.

Request Format

HTTP method: POST
URL: /kyc/sessions
Content-Type: application/json
Authorization: required

Request Parameters

Parameter	Type	Location	Required	Description
token	string	Header	✅	User JWT token

Request Body (JSON)

Field	Type	Required	Description
token	string	✅	User JWT token
page	integer	❌	Page number (pagination)
pageSize	integer	❌	Page size (pagination)

Request Example (cURL)

curl -X POST "https://api.enface.ai/kyc/sessions"   -H "Content-Type: application/json"   -H "Authorization: Bearer jwt.temporary.token"   -d '{
    "token": "jwt.temporary.token",
    "page": 1,
    "pageSize": 20
  }'

Response Examples

Success (200 OK)

{
  "status": "ok",
  "results": [
    {
      "sessionId": "00000000-0000-0000-0000-000000000000",
      "clientId": "00000000-0000-0000-0000-000000000000",
      "status": "success",
      "spent": 136.945,
      "results": [
        {
          "spent": 8.779,
          "status": "success",
          "type": "document",
          "docName": "UK - Passport (2006)",
          "image": "url",
          "imageFull": "url",
          "checks": [
            {
              "caption": "fraud",
              "items": [
                {
                  "caption": "isEdited",
                  "status": "success"
                }
              ]
            }
          ],
          "ocr": {
            "fields": [
              {
                "conf": "high",
                "title": "Surname",
                "value": "DOE"
              }
            ],
            "status": "success"
          },
          "errors": [
            "[document] text fields not visible"
          ]
        }
      ],
      "createdAt": "2025-05-21T08:19:21.212Z",
      "isClientNew": false
    }
  ]
}

Error (400 invalid schema)

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

Error (400 no access)

{
  "message": "no access",
  "status": "error"
}