verification.ping

Passport reported both the start and the end of a play

Sent once a play's Passport has reported both a start (CONTENT_STARTED) and an end (CONTENT_FINISHED). A play that starts but never finishes never sends this event. events holds the raw Passport events for the play, not a derived status. Each endpoint receives this at most once per play.

Delivery headers

POST /your/endpoint HTTP/1.1
Content-Type: application/json
X-Vojo-Signature: t=1761037200,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd

Example payload

{
  "eventType": "verification.ping",
  "attemptId": "att_7Hq7",
  "eventId": "evt_ping_01",
  "playId": "ply_123",
  "organisationId": "org_123",
  "screenId": "scr_123",
  "creativeId": "adv_123",
  "externalPlayId": null,
  "t0": "1761037200",
  "events": [
    {
      "eventId": "cve_1",
      "type": "PASSPORT",
      "eventType": "CONTENT_STARTED",
      "createdAt": "1761037200",
      "metadata": null
    },
    {
      "eventId": "cve_2",
      "type": "PASSPORT",
      "eventType": "FINGERPRINT_SEQUENCE_FINISHED",
      "createdAt": "1761037203",
      "metadata": null
    },
    {
      "eventId": "cve_3",
      "type": "PASSPORT",
      "eventType": "CONTENT_FINISHED",
      "createdAt": "1761037215",
      "metadata": null
    }
  ]
}

Payload

Fires once a play's Passport (WRAPPER) track has recorded both a start and an end event. events is the full raw set of Passport events for this play, in createdAt order — not a derived summary.

eventTypestringRequired
Always verification.ping
eventIdstringRequired
Stable per-event id, constant across retries (injected at delivery). Dedupe on this.
playIdstringRequired
organisationIdstringRequired
t0stringRequired
Epoch (seconds) the play opened.
eventsarray of objectsRequired
Show 5 fields
- eventIdstring or nullRequired
- typestringRequired
  Always PASSPORT
- eventTypestring or nullRequired
  One of CONTENT_STARTED, FINGERPRINT_SEQUENCE_FINISHED, CONTENT_FINISHED
- createdAtstringRequired
  Epoch (seconds) this raw event was recorded.
- metadataany
  Your own data, returned unchanged — never scored. Whatever the player sent, verbatim; null when none was sent.
attemptIdstring
Per-attempt id; CHANGES on each retry. Do not dedupe on this.
screenIdstring or null
creativeIdstring or null
externalPlayIdstring or null
Your own per-play id, when the player supplied one at playback.

Handling this event

Verify the signature, reply with a 2xx within 20 seconds, then process the event in the background. Retries reuse the same event id, so deduplicate on it.