Events
Events arrive as op 0 messages. The t field names the event and s is its sequence number. There are three events.
READY
Sent once after a successful IDENTIFY. session_id identifies the session for resume. Events after head_seq are delivered to you. Earlier ones are not.
- Server sends
| Field | Type | Description |
|---|---|---|
session_id | string | Identifies this session. Keep it to resume, and treat it like a token. |
head_seq | number | Sequence number of the newest event when the session started. You receive events after it. |
s is null.
{ "op": 0, "t": "READY", "s": null, "d": { "session_id": "...", "head_seq": 1234 }}RESUMED
Sent after a successful RESUME, once every missed event has been replayed.
- Server sends
d is empty and s is null. Every missed event has been replayed before this arrives.
{ "op": 0, "t": "RESUMED", "s": null, "d": {}}OPPORTUNITY_CREATE
Sent when a new opportunity is added. It carries summary fields only: nothing about you, your account or any other user. The values in the example are made up.
- Server sends
| Field | Type | Description |
|---|---|---|
id | string | Identifier of the event. The same event always has the same id, so use it to skip repeats. |
occurred_at | string | When the opportunity was added, as an ISO 8601 timestamp. |
opportunity | object | Summary of the opportunity. The fields below sit inside it. |
opportunity.id | number | Opportunity identifier. |
opportunity.title | string or null | Job title. |
opportunity.employer | string or null | Employer name. |
opportunity.location | string or null | Place of work, such as a city. |
opportunity.type | string or null | Kind of opportunity, for example apprenticeship. |
opportunity.closing_date | string or null | Last day to apply, as a date. |
opportunity.url | string or null | Link to the opportunity on Apprentice Wizard. |
s is the sequence number of the event. A field that is not known yet is null. Fields are never guessed.
{ "op": 0, "t": "OPPORTUNITY_CREATE", "s": 1235, "d": { "id": "9b2f6c1e-...", "occurred_at": "2026-11-05T10:15:00Z", "opportunity": { "id": 48213, "title": "Software Engineering Apprentice", "employer": "Example Ltd", "location": "Leeds", "type": "apprenticeship", "closing_date": "2026-12-01", "url": "https://apprenticewizard.co.uk/discover/48213" } }}Events arrive in increasing s order, so keep the last one you processed. Delivery is at least once, so the same event can arrive twice. See repeats and stable identifiers.