Skip to main content
GET
Get all radars
Results are ordered by created_at from newest to oldest, with radar_id as the tie-breaker. The response’s count is the number of radars on the current page, not the total number of matching radars. Use this endpoint to reconcile the radar inventory in your system with TAMradar—for example after an interrupted sync, a missed creation response, or an integration incident. Follow every cursor to complete the traversal. If radars may have been created while you were paging, start a fresh request without a cursor to pick them up.

Pagination

Start without a cursor. When has_more is true, send the returned next_cursor as the next request’s cursor:
Repeat the same radar_id, radar_type, radar_status, and created_since filters on every page. If you change a filter, restart without a cursor. Treat cursors as opaque: do not parse, construct, or modify them. A traversal is not a frozen snapshot. Radars created after you fetch the first page are newer than its cursor, so they do not disrupt the remaining pages. Start a new request without a cursor to discover them.

Creation-time filtering

Use created_since to return only radars created at or after an inclusive ISO 8601 timestamp with a timezone:
This filters radar creation time only. It does not find radars whose status or configuration changed after the timestamp.
Unknown query parameters return 400. In particular, pass the response field next_cursor back using the request parameter cursor.

Authorizations

x-api-key
string
header
required

Query Parameters

radar_id
string

Comma-separated list of radar IDs (UUID format, max 50). Returns only the specified radars. Can be combined with other filters. Radar IDs that don't exist or don't belong to your account are silently excluded.

Example:

"uuid1,uuid2,uuid3"

limit
integer
default:50

Maximum number of radars to return on this page. Values above 500 return 400. Leave empty to use the default value (50).

Required range: 1 <= x <= 500
radar_type
enum<string>

Filter by radar type. Leave empty to return all types.

Available options:
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_posts,
contact_social_engagements,
industry_mentions,
industry_funding_rounds,
industry_new_companies,
industry_job_openings
radar_status
enum<string>

Filter by radar status. 'active' indicates the radar is operational; 'inactive' includes every non-active state.

Available options:
active,
inactive
cursor
string

Opaque pagination cursor returned in next_cursor on the previous page. Omit for the first page. Repeat the same filters on every cursor request. Do not parse, construct, or modify this value.

Minimum string length: 1
created_since
string<date-time>

Return only radars created at or after this inclusive ISO 8601 timestamp. A timezone is required. This filters creation time only, not later status or configuration changes. Repeat the same value on every cursor request.

Example:

"2026-09-07T09:00:00.000Z"

Response

Successfully retrieved radars

status
enum<string>
required
Available options:
success
code
enum<integer>
required
Available options:
200
message
string
required
count
integer
required

Number of radars returned on this page, not the total number of matching radars

limit
integer
required

Effective page limit used for the request

has_more
boolean
required

Whether another page is available

next_cursor
string | null
required

Opaque cursor for the next page. Null on the final or an empty page.

Minimum string length: 1
data
object[]
required
timestamp
string<date-time>
required