Response Codes

Status	Meaning
`200`	Signals found. The company exists in our database and matching signals were returned. If the company exists but your filters (e.g. `signal_types`, `detected_after`) narrow results to zero, you will still receive a `200` with an empty `signals` array — the `coverage` object will show what signal types and date ranges are available for this company.
`404`	Company not found. This company does not exist in our database. No credits are consumed.
`400`	Invalid request. Missing required parameters or invalid values.
`401`	Unauthorized. Invalid or missing API key.
`402`	Credits exhausted. Monthly credit limit reached.
`429`	Rate limited. Too many requests.

404 Response Example

{
  "error": "company_not_found",
  "message": "No signals found for this company. This company may not be in our database or may not have recent signal activity.",
  "code": 404
}

200 with Filters (no matching signals)

When the company exists but your filters produce zero results, the coverage object tells you what IS available:

{
  "company": { "name": "Google", "domain": "google.com", ... },
  "signals": [],
  "signal_summary": {},
  "coverage": {
    "total_before_filters": 5362,
    "total_after_filters": 0,
    "signal_types_available": ["hiring-velocity", "news", "podcast-appearance", ...],
    "date_range": { "earliest": "2025-01-02T...", "latest": "2026-05-03T..." }
  }
}

📘
Tip: Use the coverage object to understand what signal data is available before adjusting your filters.

200Enriched company with signals

400Invalid request parameters

401Missing or invalid authentication

404Resource not found

429Rate limit exceeded