Skip to main content
GET
Poll for radar updates
For recovery and reconciliation steps, see Keep your system in sync.

Authorizations

x-api-key
string
header
required

Query Parameters

radar_id
string

Filter by one or more radar IDs. Comma-separated UUIDs, maximum 10. If a radar_id belongs to a different account, it is silently ignored (returns 0 results for that ID).

radar_type
string

Filter by one or more radar types. Comma-separated. Valid values: company_new_hires, company_job_openings, company_promotions, company_reviews, company_mentions, company_social_posts, company_social_posts_cxo, company_social_engagements, contact_job_changes, contact_social_engagements, contact_social_posts, industry_mentions, industry_funding_rounds, industry_new_companies, industry_job_openings.

update_type
string
default:radar_finding

Filter by update type. Comma-separated. Valid values: radar_finding, radar_failure. Defaults to radar_finding only — you must explicitly opt in to receive radar_failure updates. radar_failure reports failures after a radar has been created; for failures during bulk creation, use the bulk-status endpoint.

domain
string

Filter by one or more tracked domains. Comma-separated, maximum 10. Only applicable to company radar types — industry radar updates do not have a domain.

since
string<date-time>

Return only updates with a discovered_at (the time the update was added to your feed) at or after this timestamp. Accepts any valid ISO 8601 date or datetime string. For incremental polling, use the highest discovered_at from your last complete sync, about one minute earlier, and deduplicate by update_id (see Incremental Polling).

cursor
string

Pagination cursor returned as next_cursor from a previous response. Pass this to retrieve the next page of results. Cursors are opaque — do not parse or modify them. A cursor that is no longer valid returns 400 (Invalid cursor); restart from the first page with the same since and filters.

limit
integer
default:25

Maximum number of updates to return. Defaults to 25. Minimum 1, maximum 100.

Required range: 1 <= x <= 100

Response

Updates retrieved successfully

status
enum<string>
Available options:
success
code
enum<integer>
Available options:
200
message
string
updates
object[]

Array of update payloads. Each item is identical in shape to a webhook delivery payload.

has_more
boolean

Whether more updates exist beyond this page. If true, pass next_cursor to retrieve the next page.

next_cursor
string | null

Opaque cursor encoding the position of the last item on this page. Pass as cursor on the next request. Null when has_more is false.

timestamp
string<date-time>