List the job changes a watchlist has detected
Read the job changes a watchlist has already detected — to backfill a CRM from history, to reconcile against what your webhook received, or to work out why a watched person produced no lead.
Input: signalId (path), plus optional confirmedOnly (default true — only real job moves, the same set delivered to your webhook; set false to also see candidate changes that were checked and dismissed, such as a headline edit or a reworded title), limit (1-500, default 100) and offset.
Output: total and changes — each with id, detectedAt, changeType (company, title, or both), previousTitle / previousCompany, newTitle / newCompany, and leadId (matching contact.lead_id in the webhook payload, or null when the change was not confirmed).
Changes are newest-first. A dismissed change with leadId: null is the answer to 'this person changed job, why did I get nothing' — the profile edit was judged not to be a real move.
Request
- Base URL: https://api.rodz.io (the document declares no server; this is the origin it was published from)
- URL: https://api.rodz.io/api/v1/watchlists/{signalId}/changes
- Auth: HTTP bearer
Path parameters
Id of the watchlist signal, as returned by the create endpoint.
Query parameters
True (default) returns only changes confirmed as real job moves — the same set delivered to your webhook. False also returns candidate changes that were checked and dismissed (a headline edit, a reworded title), which is useful when auditing why someone produced no lead.
Response
Successful Response
Example response
{
"changes": [
{
"changeType": "company",
"detectedAt": "2026-08-04T09:12:00+00:00",
"id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
"leadId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"newCompany": "Doctolib",
"newTitle": "VP Marketing",
"previousCompany": "Payfit",
"previousTitle": "Head of Growth"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.