Skip to main content
POST
Report a funnel-progress snapshot (GET-87)

Authorizations

token
string
query
required

Possession of the verification id in the URL path (/v1/verifications/:token/...) authenticates the SPA capture flow. No header — the id is the credential. ULIDs are large enough that existence-by-id is not a meaningful leak. Used for POST /captures/upload-url, POST /captures, GET /v1/verify/:token.

Path Parameters

token
string
required
Pattern: ^vfy_[0-9A-HJKMNP-TV-Z]{26}$
Example:

"vfy_01HXYZABCDEFGHJKMNPQRSTVWX"

Body

application/json
schema_version
enum<number>
required
Available options:
1
kind
enum<string>
required
Available options:
step_reached,
camera_permission,
abandoned
step
enum<string>
required
Available options:
landing,
ready,
capturing,
reviewing,
uploading,
camera_blocked,
success
elapsed_ms
integer
required
Required range: x >= 0
step_index
integer
Required range: x >= 0
camera_permission
enum<string>
Available options:
granted,
denied,
unavailable,
unknown

Response

Snapshot stored (and, when applicable, status flipped to abandoned).