Skip to main content
GET
/
sessions
curl -X GET \
  "https://verilock.io/api/v1/sessions?status=approved&per_page=10" \
  -H "X-API-Key: your_api_key_here" \
  -H "Accept: application/json"
{
  "data": [
    {
      "id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "kyc",
      "status": "approved",
      "reference_id": "usr_12345",
      "steps": ["document", "selfie", "face_match"],
      "applicant": {
        "first_name": "Jean",
        "last_name": "Dupont",
        "email": "jean.dupont@example.com"
      },
      "created_at": "2026-03-15T10:30:00Z",
      "completed_at": "2026-03-15T10:45:22Z"
    },
    {
      "id": "ses_f7e8d9c0-b1a2-3456-7890-abcdef123456",
      "type": "kyc",
      "status": "approved",
      "reference_id": "usr_67890",
      "steps": ["document", "selfie", "liveness", "aml"],
      "applicant": {
        "first_name": "Marie",
        "last_name": "Laurent",
        "email": "marie.laurent@example.com"
      },
      "created_at": "2026-03-14T08:15:00Z",
      "completed_at": "2026-03-14T08:32:10Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 4,
    "per_page": 10,
    "total": 38
  }
}

Query Parameters

page
integer
Page number (default: 1)
per_page
integer
Results per page, max 100 (default: 15)
status
string
Filter by status: created, processing, approved, declined, expired
from
string
Filter sessions created after this date (YYYY-MM-DD)
to
string
Filter sessions created before this date (YYYY-MM-DD)
curl -X GET \
  "https://verilock.io/api/v1/sessions?status=approved&per_page=10" \
  -H "X-API-Key: your_api_key_here" \
  -H "Accept: application/json"
{
  "data": [
    {
      "id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "type": "kyc",
      "status": "approved",
      "reference_id": "usr_12345",
      "steps": ["document", "selfie", "face_match"],
      "applicant": {
        "first_name": "Jean",
        "last_name": "Dupont",
        "email": "jean.dupont@example.com"
      },
      "created_at": "2026-03-15T10:30:00Z",
      "completed_at": "2026-03-15T10:45:22Z"
    },
    {
      "id": "ses_f7e8d9c0-b1a2-3456-7890-abcdef123456",
      "type": "kyc",
      "status": "approved",
      "reference_id": "usr_67890",
      "steps": ["document", "selfie", "liveness", "aml"],
      "applicant": {
        "first_name": "Marie",
        "last_name": "Laurent",
        "email": "marie.laurent@example.com"
      },
      "created_at": "2026-03-14T08:15:00Z",
      "completed_at": "2026-03-14T08:32:10Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 4,
    "per_page": 10,
    "total": 38
  }
}