List Radars

List public API radars for the workspace mapped to the current API key.

Endpoint

GET /api/v1/radar

Authentication

All requests require the X-Satellyte-API-Key header. See Quickstart.

Query parameters

Field	Type	Required	Notes
`status`	string	No	Filter by `active` or `paused`.
`limit`	number	No	Maximum number of radars to return. Minimum `1`, maximum `200`. Defaults to `50`.

cURL

curl -i "https://api-staging.satellyte.ai/api/v1/radar?status=active&limit=50" \
  -H "X-Satellyte-API-Key: $API_KEY"

Response (200)

{
  "data": [
    {
      "id": "nJBj9azouTmbmiOY1x3Cn",
      "name": "SaaS Banking Watch",
      "status": "active",
      "titles": ["Founder", "CEO"],
      "industries": ["saas", "ai"],
      "geos": ["Singapore"],
      "signals_to_track": ["funding", "hiring"],
      "raised_funds": true,
      "recent_job_changes": false,
      "company_size_min": 1,
      "company_size_max": 10000,
      "last_collection_at": null,
      "created_at": "2026-05-11T00:00:00.000Z",
      "updated_at": "2026-05-11T00:00:00.000Z"
    }
  ]
}

Response fields

Field	Type	Notes
`id`	string	Radar ID. Pass this to `/radar/{id}/signals` and `/radar/{id}/leads`.
`status`	string	Radar status.
`signals_to_track`	string[]	Derived signal categories currently tracked by the radar.
`last_collection_at`	string \| null	Last collection timestamp when available.

Error responses

All failed calls use the standard error envelope documented in Errors.

Status	Code	Notes
`400`	`validation_error`	Returned when query parameters are invalid, for example an unsupported `status` or an out-of-range `limit`.
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when Public API access is not enabled or the requested Public API resource is unavailable.
`429`	`rate_limit_exceeded`	Returned when the API key exceeds its configured rate limit.
`500`	`service_error`	Returned when the service cannot complete the request. Retry with backoff.