Skip to main content
GET
/
sessions
/
{id}
curl -X GET \
  "https://verilock.io/api/v1/sessions/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "X-API-Key: your_api_key_here" \
  -H "Accept: application/json"
{
  "id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "kyc",
  "status": "approved",
  "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"
  },
  "results": {
    "document": {
      "status": "approved",
      "type": "passport",
      "details": {
        "document_number": "12AB34567",
        "issuing_country": "FR",
        "expiry_date": "2030-08-21"
      }
    },
    "selfie": {
      "status": "approved"
    },
    "face_match": {
      "status": "approved",
      "score": 0.97,
      "details": {
        "similarity": "very_high"
      }
    },
    "liveness": {
      "status": "approved",
      "score": 0.99,
      "details": {
        "is_live": true
      }
    },
    "aml": {
      "status": "approved",
      "score": 0.02,
      "details": {
        "pep": false,
        "sanctions": false,
        "adverse_media": false
      }
    }
  },
  "hosted_url": "https://verilock.io/verify/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-03-15T10:30:00Z",
  "completed_at": "2026-03-15T10:45:22Z"
}

Path Parameters

id
string
required
The session ID (e.g., ses_a1b2c3d4-...)

Result Statuses

StatusDescription
approvedThe verification step passed successfully
declinedThe verification step failed
pendingThe step is still being processed
not_startedThe step has not been initiated yet
curl -X GET \
  "https://verilock.io/api/v1/sessions/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "X-API-Key: your_api_key_here" \
  -H "Accept: application/json"
{
  "id": "ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "kyc",
  "status": "approved",
  "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"
  },
  "results": {
    "document": {
      "status": "approved",
      "type": "passport",
      "details": {
        "document_number": "12AB34567",
        "issuing_country": "FR",
        "expiry_date": "2030-08-21"
      }
    },
    "selfie": {
      "status": "approved"
    },
    "face_match": {
      "status": "approved",
      "score": 0.97,
      "details": {
        "similarity": "very_high"
      }
    },
    "liveness": {
      "status": "approved",
      "score": 0.99,
      "details": {
        "is_live": true
      }
    },
    "aml": {
      "status": "approved",
      "score": 0.02,
      "details": {
        "pep": false,
        "sanctions": false,
        "adverse_media": false
      }
    }
  },
  "hosted_url": "https://verilock.io/verify/ses_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "created_at": "2026-03-15T10:30:00Z",
  "completed_at": "2026-03-15T10:45:22Z"
}