Stream verification events (SSE)
Server-Sent Events stream for real-time verification updates. This
endpoint requires request headers for the client token and publishable
key, so browser integrations should use fetch() with a readable stream
instead of native EventSource.
Reconnection: Include the Last-Event-ID header with the last
received event cursor, or pass after, to resume from where you left off.
Event format:
id: 12345
event: verification.completed
data: {"object":"verification_status","id":"vrf_123","status":"verified"}
Enabled isolated testbed: this session’s unexpired Bearer client_token is sufficient; the publishable key may be omitted.
Authorizations
Opaque verification-scoped client token. Returned when creating a verification. Treat it as a bearer secret and do not depend on its internal format.
Browser-safe publishable key. Format: pk_live_* (production) or pk_test_* (testing).
Path Parameters
Verification ID. Runtime IDs may be UUIDs during alpha; external IDs use vrf_*.
^(vrf_[a-zA-Z0-9_-]+|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$Query Parameters
Start streaming from this cursor (alternative to Last-Event-ID)
Response
SSE stream
The response is of type string.