Skip to main content
GET
/
api
/
v2
/
kyc
/
sessions
curl -X GET "https://loveandpay.io/api/v2/kyc/sessions?status=APPROVED&limit=50" \
  -H "x-api-key: pk_live_xxx" \
  -H "x-timestamp: 1706012345678" \
  -H "x-signature: a1b2c3d4e5f6..."
{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "sessionId": "verification-550e8400",
      "invoiceId": "550e8400-e29b-41d4-a716-446655440001",
      "customerId": "your-id-123",
      "customerEmail": "client@example.com",
      "customerPhone": "+79991234567",
      "status": "APPROVED",
      "verification": {
        "firstName": "Иван",
        "lastName": "Иванов",
        "fullName": "Иван Иванов",
        "dateOfBirth": "1990-01-15",
        "documentType": "passport",
        "documentCountry": "RUS",
        "faceMatchScore": 0.98,
        "livenessScore": 0.95,
        "verifiedAt": "2024-01-23T12:15:00.000Z"
      },
      "createdAt": "2024-01-23T12:00:00.000Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "sessionId": "verification-550e8401",
      "invoiceId": null,
      "customerId": "your-id-456",
      "customerEmail": "maria@example.com",
      "customerPhone": "+79991234568",
      "status": "IN_PROGRESS",
      "verification": null,
      "createdAt": "2024-01-23T13:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 50,
    "limit": 50,
    "offset": 0,
    "pages": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.loveandpay.io/llms.txt

Use this file to discover all available pages before exploring further.

Заголовки

x-api-key
string
required
Ваш API ключ
x-timestamp
string
required
Unix timestamp в миллисекундах
x-signature
string
required
HMAC-SHA256 подпись

Query параметры

limit
number
default:"50"
Количество записей (максимум 100)
offset
number
default:"0"
Смещение для пагинации
status
string
Фильтр по статусу: NOT_STARTED, IN_PROGRESS, APPROVED, DECLINED, EXPIRED
invoiceId
string
Фильтр по UUID счёта
{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "sessionId": "verification-550e8400",
      "invoiceId": "550e8400-e29b-41d4-a716-446655440001",
      "customerId": "your-id-123",
      "customerEmail": "client@example.com",
      "customerPhone": "+79991234567",
      "status": "APPROVED",
      "verification": {
        "firstName": "Иван",
        "lastName": "Иванов",
        "fullName": "Иван Иванов",
        "dateOfBirth": "1990-01-15",
        "documentType": "passport",
        "documentCountry": "RUS",
        "faceMatchScore": 0.98,
        "livenessScore": 0.95,
        "verifiedAt": "2024-01-23T12:15:00.000Z"
      },
      "createdAt": "2024-01-23T12:00:00.000Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "sessionId": "verification-550e8401",
      "invoiceId": null,
      "customerId": "your-id-456",
      "customerEmail": "maria@example.com",
      "customerPhone": "+79991234568",
      "status": "IN_PROGRESS",
      "verification": null,
      "createdAt": "2024-01-23T13:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 50,
    "limit": 50,
    "offset": 0,
    "pages": 1
  }
}
curl -X GET "https://loveandpay.io/api/v2/kyc/sessions?status=APPROVED&limit=50" \
  -H "x-api-key: pk_live_xxx" \
  -H "x-timestamp: 1706012345678" \
  -H "x-signature: a1b2c3d4e5f6..."

Данные верификации

При статусе APPROVED объект verification содержит:
ПолеОписание
firstNameИмя
lastNameФамилия
fullNameПолное имя
dateOfBirthДата рождения (YYYY-MM-DD)
documentTypeТип документа (passport, id_card)
documentCountryСтрана документа (ISO 3166-1 alpha-3)
faceMatchScoreОценка совпадения лица (0-1)
livenessScoreОценка liveness-проверки (0-1)
verifiedAtДата верификации