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.
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
Filter by status: active, paused
Filter by signal type
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.
Max signals to return (pagination). Omit to return all.
Number of signals to skip (pagination).
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.
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
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.