Verify

Stream asset verification events (SSE)

Subscribe to real-time per-asset verification status updates via Server-Sent Events. Public endpoint (optional JWT for owner identification). Sends a connected event on open — {request_id, asset_index, status, request_status} — then update events {status, timestamp} as the asset changes.

An update whose status is verified, cancelled or expired is the last one: the server closes the stream after it. cancelled and expired come from the request (the asset itself stays pending) and carry request_status. failed does not close the stream, since a failed asset can be started again. When the request is already closed at connect time — cancelled, expired, or this asset verified — the stream is connected, one such update, and the close.

Rate limited: 10 connections per minute per IP. Includes heartbeat to keep connection alive through Cloudflare.

get/api/v1/verify/request/{id}/assets/{assetIndex}/events

Request

  • Base URL: https://api.proof.holdings
  • URL: https://api.proof.holdings/api/v1/verify/request/{id}/assets/{assetIndex}/events
  • Auth: none declared

Path parameters

idstring required

MongoDB ObjectId

Example:507f1f77bcf86cd799439011
assetIndexstring required

Asset index (0-based)

Example:0

Response

SSE event stream

Changes

No recorded changes to this operation across all 1 revision of this API.