Account Management

List signals

View all your configured lead detection signals and their current status — see which ones are active, how many leads they detected today and in total, and review each signal's full configuration.

Input: API authentication (via API key); optional query filters: status (active or paused), signalTypeId (filter by signal type, e.g., competitor_relationship_monitoring, job_changes), and createdByThisKey (true returns only the signals created with the API key making the call, instead of every signal on the account — use it to stop a staging integration from seeing production signals; signals created in the dashboard belong to no key and are never returned when it is true).

Output: An array of signals, each with: id, name, status, signalTypeId, full config (the criteria you're monitoring: linkedinCompanyUrls, targetPersonas, locations, excludedTitles, etc.), webhookUrl, dailyLeadLimit, leadsToday, leadsTotal, duplicateHandling policy, and createdAt/updatedAt/lastLeadAt timestamps. Also returns a count of total signals.

Signals waiting on you: actionRequired=true returns only the active signals that produce nothing until you act — a New Decision Maker or Account watchlist whose company matching waits for your confirmation (MATCHING_CONFIRMATION_REQUIRED), a Company Followers signal whose follower extraction waits for a quote (QUOTE_REQUIRED), or one whose extraction stopped because a LinkedIn company page it names does not exist (COMPANY_PAGE_UNAVAILABLE) — each with its warnings, which give the quote and the call that unblocks it. Poll it from a dashboard, or let us tell you: when a signal starts waiting on you, the account owners get an email and the signal's webhookUrl receives a signal.action_required event (see the Webhooks section), followed by signal.action_resolved once it no longer waits.

get/api/v1/signals

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

Query parameters

statusstring nullable

Filter by status: active, paused

signalTypeIdstring nullable

Filter by signal type

idsstring nullable

Fetch only these signals — a comma-separated list of ids (e.g. ?ids=id1,id2,id3). Up to 100 ids per request; for more, make multiple calls or page the full list with limit/offset.

limitinteger nullable

Max signals to return (pagination). Omit to return all.

offsetinteger

Number of signals to skip (pagination).

actionRequiredboolean

true returns only the active signals that produce nothing until you act — a watchlist whose company matching waits for your confirmation, a Company Followers signal whose extraction waits for a quote — each with its warnings, which say what to do and which call does it. Default false.

createdByThisKeyboolean

Return only the signals created with the API key making this call, instead of every signal on the account. Use it to keep a staging integration from seeing production signals. Signals created in the dashboard belong to no key and are never returned when this is true.

Response

Successful Response

totalinteger required

Example response

{
  "signals": [
    {
      "config": {
        "targetPersonas": [
          "Head of Sales"
        ]
      },
      "createdAt": "2026-10-09T09:12:00+00:00",
      "dailyLeadLimit": 100,
      "duplicateHandling": "refuse",
      "id": "d4bab73d-5c1e-4b7a-9f2e-3a6b8c0d1e2f",
      "leadsToday": 0,
      "leadsTotal": 0,
      "name": "Key accounts - new decision makers",
      "signalTypeId": "new_decision_maker_watchlist",
      "status": "active",
      "updatedAt": "2026-10-09T09:15:00+00:00",
      "warnings": [
        {
          "code": "MATCHING_CONFIRMATION_REQUIRED",
          "field": "companies",
          "message": "12,000 companies on this list must be matched to their LinkedIn company page before they can be watched, for at most 600.0 credits (0.05 per company; companies already matched are free). Nothing is matched or charged until you confirm with POST /api/v1/watchlists/d4bab73d-5c1e-4b7a-9f2e-3a6b8c0d1e2f/companies/confirm-matching and {\"confirm\": true}.",
          "severity": "warning",
          "values": [
            "600.0",
            "12000"
          ]
        }
      ],
      "webhookUrl": "https://your-server.com/webhooks/rodz"
    }
  ],
  "total": 1
}

Changes

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