Expire a session
Manually expires an active session, preventing the user from completing the verification flow. Any in-progress capture is canceled.
The session can be re-activated later using the
POST /sessions/{session_id}/resume endpoint.
Sessions that are already completed, expired, or redacted cannot
be expired.
Authentication
X-API-Keystring
Organization API key. Keys are prefixed with vk_live_ (production) or
vk_sandbox_ (sandbox).
Path parameters
session_id
Session ID (ses_*).
Headers
Verifa-Version
API version date string (e.g. 2026-02-01). If omitted, the version
pinned to your API key is used.
Idempotency-Key
Unique key for idempotent requests. Cached for 24 hours. Sending the
same key with different parameters returns 422.
Response
Session expired.
id
status
expired_at
Errors
400
Bad Request Error
401
Unauthorized Error
404
Not Found Error