Get Radar Leads

Leads detected for one radar.

Endpoint

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

Authentication

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

Path parameters

Field	Type	Notes
`id`	string	Radar ID.

Query parameters

Field	Type	Required	Notes
`min_score`	number	No	Filter to leads at or above this score.
`date_range`	string	No	Range token, for example `last_30_days`.

cURL

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

Response (200)

Example response when radar leads exist:

{
  "data": [
    {
      "id": "lead_123",
      "name": "Alex Morgan",
      "title": "AI Infrastructure Lead",
      "company": "OpenAI",
      "linkedin_url": "https://www.linkedin.com/in/alex-morgan",
      "location": "San Francisco, California, United States",
      "score": 86,
      "signal_context": [
        {
          "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": 86
        }
      ]
    },
    {
      "id": "lead_456",
      "name": "Jamie Lee",
      "title": "Head of Partnerships",
      "company": "Stripe",
      "linkedin_url": "https://www.linkedin.com/in/jamie-lee",
      "location": "Singapore",
      "score": 74,
      "signal_context": [
        {
          "id": "lead_456:0",
          "type": "funding_announcement",
          "lead_id": "lead_456",
          "lead_name": "Jamie Lee",
          "company": "Stripe",
          "title": "Head of Partnerships",
          "detail": "Recent funding announced",
          "source_url": "https://example.com/funding-announcement",
          "detected_at": "2026-05-02T00:00:00.000Z",
          "score": 74
        }
      ]
    }
  ]
}

Response fields

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

Empty array if no leads 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` or out-of-range `min_score`.
`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.