verification.score.preliminary

A play's score as soon as its Passport report is complete

Sent when a play's Passport has reported both a start and a finish, at the same moment as verification.ping, with the score as it stands then. Use it for live views. The final score can be higher or lower than this one, because evidence that arrives before the play settles is still scored (a Harvester read can raise it, or contradict Passport and lower it), so bill and report on verification.score.final.

Each endpoint receives this at most once per play. It isn't sent for a play that's already final by then, or for a play with no Passport report.

Delivery headers

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

Example payload

{
  "eventType": "verification.score.preliminary",
  "attemptId": "att_7Hq0",
  "eventId": "evt_prelim_01",
  "playId": "ply_123",
  "organisationId": "org_123",
  "screenId": "scr_123",
  "creativeId": "adv_123",
  "externalPlayId": null,
  "t0": "1761037200",
  "tracks": {
    "passport": {
      "eventCount": 3
    },
    "player": {
      "eventCount": 0
    },
    "harvester": {
      "eventCount": 0
    }
  },
  "score": {
    "preliminary": 70,
    "band": "HIGH",
    "phase": "PRELIMINARY",
    "policyVersion": "trust-score@3",
    "scoredAt": "1761037216"
  }
}

Payload

The play's score when its Passport report completed, before it settled. Same tracks and score shape as VerificationScoreEvent, with score.preliminary in place of score.final, plus the play's identity fields as in verification.ping. tracks.*.eventCount are raw received-event counts at firing time.

eventTypestringRequired
Always verification.score.preliminary
eventIdstringRequired
Stable per-event id, constant across retries (injected at delivery). Dedupe on this.
playIdstringRequired
organisationIdstringRequired
t0stringRequired
Epoch (seconds) the play opened.
tracksobjectRequired
Show 3 fields
- passportobjectRequired
  Show 1 field
  - eventCountintegerRequired
- playerobjectRequired
  Show 1 field
  - eventCountintegerRequired
- harvesterobjectRequired
  Show 1 field
  - eventCountintegerRequired
scoreobjectRequired
Show 5 fields
- preliminaryintegerRequired
- bandstring or nullRequired
  One of LOW, MEDIUM, HIGH, MAX
- phasestringRequired
  Always PRELIMINARY
- policyVersionstring or nullRequired
- scoredAtstring or nullRequired
  Epoch (seconds) of the score this event reports.
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.