Skip to main content
GET
/
v1
/
sessions
/
{id}
Get a session by ID
curl --request GET \
  --url http://127.0.0.1:8787/v1/sessions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "<string>",
    "nfc_tries_used": 1,
    "liveness_tries_used": 1,
    "contract_version": 123,
    "share_fields": {},
    "redirect_url": "<string>",
    "webhook_endpoint_id": "<string>",
    "verification_url": "<string>",
    "expires_at": "<string>",
    "completed_at": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "cancel_token": "<string>"
  },
  "error": null
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The ID of the verification session to retrieve (e.g. vs_...).

Pattern: ^vs_[A-Za-z0-9]{64}$

Response

Successful operation.

​
data
object
required
Example:
{
  "id": "vs_mza7vecksrtyfw193ekcvl5vnws3bt1lz96buu3iw7zidckf8dga2zx2echb3t16",
  "status": "created",
  "failure_code": null,
  "nfc_tries_used": 0,
  "liveness_tries_used": 0,
  "contract_version": 1,
  "share_fields": {
    "document_type_code": {
      "required": false,
      "reason": "Needed to know the document type code",
      "source": "rc"
    },
    "date_of_birth": {
      "required": true,
      "reason": "Needed to verify age eligibility",
      "source": "rc"
    },
    "kayle_document_id": {
      "required": true,
      "reason": "Sharing \"Kayle Document ID\"",
      "source": "default"
    }
  },
  "redirect_url": "https://example.com/redirect",
  "webhook_endpoint_id": null,
  "verification_url": "https://verify.kayle.id/vs_mza7vecksrtyfw193ekcvl5vnws3bt1lz96buu3iw7zidckf8dga2zx2echb3t16",
  "expires_at": "2025-01-01T00:00:00Z",
  "completed_at": null,
  "created_at": "2025-01-01T00:00:00Z",
  "updated_at": "2025-01-01T00:00:00Z"
}
​
error
null
required