Watchlists

List the companies a watchlist is watching

See which companies a Job Offers Watchlist is watching, and — crucially — which of them we could not match to a real employer, since those are silently never checked for postings.

Input: signalId (path parameter).

Output: total, matched (entries matched to a real employer and being checked), unmatched (entries that are not), and companies — each with id (pass it to DELETE), companyName, companyDomain, companyLinkedinUrl, matched, status (active or archived), lastCheckedAt, and lastJobSeenAt (the most recent posting delivered for that company).

Check unmatched first when a watchlist delivers less than you expected: an unmatched company looks identical to a company that simply is not hiring. Fix one by re-adding it under a different spelling of its name, or by its domain.

get/api/v1/watchlists/{signalId}/companies

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}/companies
  • Auth: HTTP bearer

Path parameters

signalIdstring required

Id of the watchlist signal, as returned by the create endpoint.

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Response

Successful Response

totalinteger required
matchedinteger required

Entries matched to a real employer and being checked.

unmatchedinteger required

Entries not currently being checked — the sum of pending and notFound. Reported so a half-working list is visible instead of looking like a list that simply is not hiring. Which of the two it is decides what to do about it, so read those two rather than this total.

pendinginteger required

Entries not looked up yet. A large list is worked through over successive passes; these need no action and resolve on their own.

notFoundinteger required

Entries looked up with no matching employer. These will not resolve on their own — re-add them under their public trading name or their domain.

Example response

{
  "companies": [
    {
      "companyDomain": "doctolib.fr",
      "companyLinkedinUrl": "https://www.linkedin.com/company/doctolib",
      "companyName": "Doctolib",
      "id": "d4e5f6a7-b8c9-0123-def4-56789012345a",
      "lastCheckedAt": "2026-08-04T09:12:00+00:00",
      "lastJobSeenAt": "2026-08-03T00:00:00+00:00",
      "matched": true,
      "resolutionStatus": "resolved",
      "status": "active"
    }
  ],
  "matched": 49,
  "notFound": 51,
  "pending": 100,
  "total": 200,
  "unmatched": 151
}

Changes

No recorded changes to this operation across all 1 revision of this API.