Signals

Every signal your monitors delivered, newest first, whichever way they were delivered (email or webhook): the record of what Cornect told you, and when. Reading it is free; you paid for each signal when it was delivered.

Any token can call these (read), sent as Authorization: Bearer cornect_….

List signals#

GET/api/v1/signals

Query parameter	Type	Description
`signal_type`	string	Only one signal type: job_openings, financing_events, news_events or connections.
`family`	string	Only one kind of event, e.g. funding or hiring (not on Summary).
`monitor_id`	string (UUID)	Only signals from this monitor.
`domain`	string	Only this company.
`since`	date (YYYY-MM-DD)	Delivered on or after this UTC day.
`until`	date (YYYY-MM-DD)	Delivered on or before this UTC day.
`limit`	integer, 1–200	Page size. Default 50.
`offset`	integer	Rows to skip.

curl -X GET https://api.cornect.io/api/v1/signals?family=funding&since=2026-10-01 \
  -H "Authorization: Bearer cornect_your_token_here"

Response:

json

{
  "items": [
    {
      "id": "0c8f…",
      "fired_at": "2026-10-10T09:00:21Z",
      "signal_type": "job_openings",
      "signal_label": "Job Opening",
      "domain": "acme.com",
      "cron_job_id": "3f1c2a9e-…",
      "cron_job_name": "Competitors hiring",
      "delivery_method": "webhook",
      "pl_item_id": "a1b2…",
      "webhook_delivery_id": "77d0…",
      "delivery_status": "succeeded",
      "response_status": 200,
      "content_available": true,
      "headline": "Head of Sales, EMEA",
      "details": ["Head", "London, United Kingdom", "Sales"],
      "source_url": "https://jobs.example.com/acme/123",
      "family": "hiring",
      "family_label": "Hiring",
      "category": null,
      "happened_on": "2026-10-08"
    }
  ],
  "total": 44,
  "limit": 50,
  "offset": 0
}

content_available: false is not an empty signal

It means the signal was delivered but its text was not kept (some older email deliveries). Something did happen; show the row, not a blank. cron_job_id and cron_job_name are the monitor that delivered it.

Field	Type	Description
`id`	string
`fired_at`	string	When the monitor delivered it.
`signal_type`	string	Its signal type, as in a monitor's `signal_types`.
`signal_label`	string	The signal type, readable, e.g. `Job Opening`.
`domain`	string	The company's domain.
`cron_job_id`	string	The monitor that delivered it.
`cron_job_name`	string	That monitor's name.
`delivery_method`	string	`email` or `webhook`.
`pl_item_id`	string	The signal's own id: the same signal always has the same id.
`webhook_delivery_id`	string	For webhook delivery: the delivery's id.
`delivery_status`	string	For webhook delivery: whether your endpoint accepted it.
`response_status`	integer	For webhook delivery: the HTTP status your endpoint answered.
`content_available`	boolean	False when the signal was delivered but its text was not kept (some older email deliveries). It does not mean nothing happened.
`headline`	string	What happened, in a line.
`details`	string[]	Short facts: location, amount, seniority and the like.
`source_url`	string	Where it was found: the job post or the article.
`family`	string	What kind of event: funding, mna, leadership, hiring, expansion, contraction, commercial, product, technology or other. Null when unknown.
`family_label`	string	The family, readable.
`category`	string	For news: the event's category, e.g. `receives_financing`.
`happened_on`	string	When it happened (YYYY-MM-DD), which can be earlier than when it was delivered.

Summary#

GET/api/v1/signals/summary

Counts for the same filters as List signals, except family: in total, in the last 24 hours and 7 days, and per kind of event (every kind listed, zeros included).

Field	Type	Description
`total`	integer	Signals delivered.
`last_24h`	integer	Of those, in the last 24 hours.
`last_7d`	integer	Of those, in the last 7 days.
`unclassified`	integer	Signals whose kind of event is unknown; counted in `total` only.
`by_family`	SignalFamilyCount[]	Every kind of event, zeros included.

Export as CSV#

GET/api/v1/signals/export

The same signals as a CSV file, streamed, with the List signals filters (no paging). Columns: fired_at_utc, signal_type, company_domain, headline, details, source_url, cron_job_name, delivery_method, delivery_status, content_available, predictleads_item_id, signal_family, happened_on. New columns are only ever added at the end. Free.

bash

curl "https://api.cornect.io/api/v1/signals/export?since=2026-10-01" \
  -H "Authorization: Bearer cornect_your_token_here" \
  -o signals.csv

Errors#

Code	Status	When
`INVALID_TOKEN`	401	Token not found or revoked.
—	422	An unknown signal_type or family, or a bad date.
—	429	Rate limit exceeded (120/min; 30/min for the export).

Signals

List signals#

Summary#

Export as CSV#

Errors#

Related#