List the people a watchlist is watching
See exactly who a Job Change Watchlist is watching, and what role each person was last seen in — so you can confirm the list you sent is the list being checked before you wait a week for changes that were never going to come.
Input: signalId (path — the watchlist signal's id), plus optional status (active, archived, or error; omit for all), search (case-insensitive match on name, email, employer, or profile URL), limit (1-500, default 100) and offset.
Output: total (entries matching the filter, ignoring pagination) and profiles — each with id (pass it to DELETE), linkedinUrl, firstName / lastName / email, currentTitle and currentCompany (the baseline the next check compares against), status, and lastCheckedAt (null until the first check runs).
Two states are worth acting on: error means the profile could not be read repeatedly and is producing nothing, and a currentCompany that is still null long after lastCheckedAt was set means we could not read that person's employer, so an employer change cannot be detected for them.
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}/profiles
- Auth: HTTP bearer
Path parameters
Id of the watchlist signal, as returned by the create endpoint.
Query parameters
Filter by entry state. Omit to get every entry.
Case-insensitive match on name, email, employer, or profile URL.
Response
Successful Response
Example response
{
"profiles": [
{
"currentCompany": "Payfit",
"currentTitle": "Head of Growth",
"email": "marie.dupont@payfit.com",
"firstName": "Marie",
"id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"lastCheckedAt": "2026-08-04T09:12:00+00:00",
"lastName": "Dupont",
"linkedinUrl": "https://www.linkedin.com/in/marie-dupont",
"status": "active"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.