Company Signals

All signals stored for a company ID or domain key.

Endpoint

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

Authentication

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

Path parameters

Field	Type	Notes
`id`	string	Company identifier or domain (for example `openai.com`, `stripe.com`).

cURL

curl -i "https://api-staging.satellyte.ai/api/v1/signals/company/openai.com" \
  -H "X-Satellyte-API-Key: $API_KEY"

Response (200)

Example response when company signals exist:

{
  "data": [
    {
      "id": "lead_123:0",
      "type": "company_hiring",
      "company": "OpenAI",
      "company_domain": "openai.com",
      "lead_id": "lead_123",
      "lead_name": "Alex Morgan",
      "lead_title": "AI Infrastructure Lead",
      "linkedin_url": "https://www.linkedin.com/in/alex-morgan",
      "title": "Hiring AI infrastructure engineers",
      "detail": "Detected from lead/company signals",
      "source_url": "https://example.com/job",
      "detected_at": "2026-05-01T00:00:00.000Z",
      "score": 20
    },
    {
      "id": "lead_456:0",
      "type": "funding_announcement",
      "company": "OpenAI",
      "company_domain": "openai.com",
      "lead_id": "lead_456",
      "lead_name": "Jamie Lee",
      "lead_title": "Head of Partnerships",
      "linkedin_url": "https://www.linkedin.com/in/jamie-lee",
      "title": "OpenAI announces a new funding round",
      "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	Signal records stored for the requested company ID or domain key.
`data[].id`	string	Stable signal item ID.
`data[].type`	string	Signal type, for example `"company_hiring"`, `"funding_announcement"`, or `"tech_changes"`.
`data[].company`	string \| null	Company name associated with the signal.
`data[].company_domain`	string \| null	Normalized company domain when available.
`data[].lead_id`	string	Lead ID associated with the signal.
`data[].lead_name`	string	Lead name associated with the signal.
`data[].lead_title`	string \| null	Lead title when available.
`data[].linkedin_url`	string \| null	Lead LinkedIn profile URL when available.
`data[].title`	string \| null	Headline or title of the signal.
`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	Signal or lead score when available.

Empty array if no signals are known.

Error responses

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

Status	Code	Notes
`400`	`validation_error`	Returned when the company ID or domain key is missing or invalid.
`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.