Get Radar Signals

Flattened signals detected for one radar.

Endpoint

GET /api/v1/radar/{id}/signals

Authentication

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

Path parameters

Field	Type	Notes
`id`	string	Radar ID returned by `/radar/create`.

Query parameters

Field	Type	Required	Notes
`date_range`	string	No	Range token, for example `last_30_days`.

cURL

curl -i "https://api-staging.satellyte.ai/api/v1/radar/$RADAR_ID/signals?date_range=last_30_days" \
  -H "X-Satellyte-API-Key: $API_KEY"

Response (200)

Example response when radar signals exist:

{
  "data": [
    {
      "id": "lead_123:0",
      "type": "company_hiring",
      "lead_id": "lead_123",
      "lead_name": "Alex Morgan",
      "company": "OpenAI",
      "title": "AI Infrastructure Lead",
      "detail": "Hiring AI infrastructure engineers",
      "source_url": "https://example.com/job",
      "detected_at": "2026-05-01T00:00:00.000Z",
      "score": 20
    },
    {
      "id": "lead_456:0",
      "type": "funding_announcement",
      "lead_id": "lead_456",
      "lead_name": "Jamie Lee",
      "company": "OpenAI",
      "title": "Head of Partnerships",
      "detail": "Recent funding announced",
      "source_url": "https://example.com/funding-announcement",
      "detected_at": "2026-05-02T00:00:00.000Z",
      "score": 25
    }
  ]
}

Response fields

Field	Type	Notes
`data`	array	Flattened signal records detected for the requested radar.
`data[].id`	string	Stable signal item ID.
`data[].type`	string	Signal type, for example `"company_hiring"` or `"funding_announcement"`.
`data[].lead_id`	string	Lead ID associated with the signal.
`data[].lead_name`	string	Lead name associated with the signal.
`data[].company`	string \| null	Company associated with the lead or signal.
`data[].title`	string \| null	Lead title, role, job title, or signal headline when available.
`data[].detail`	string \| null	Free-form signal detail or provenance text.
`data[].source_url`	string \| null	Source URL for the signal when available.
`data[].detected_at`	string \| null	Timestamp when the signal was detected.
`data[].score`	number \| null	Lead or signal score when available.

Empty array if no signals are known for the requested radar and filters.

Error responses

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

Status	Code	Notes
`400`	`validation_error`	Returned when the radar ID or query parameters are invalid, for example an unsupported `date_range`.
`401`	`unauthorized`	Returned when `X-Satellyte-API-Key` is missing, invalid, or expired.
`404`	`not_found`	Returned when Public API access is not enabled, the radar is unavailable, 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.