Skip to main content
GET
Retrieve an alert and its runs
Each run of an alert produces either a lead search, listed in searches, or a company list, listed in lists (Custom account alerts, for example). Fetch a run’s results from its results_url: Retrieve a Search for leads, Retrieve a List for companies.

Only the new runs

To check for new results, pass since with the checked_at value of your previous call:
Only the runs created at or after since are returned. A run whose status is not finished is still running: fetch its results_url again later. To be notified instead of polling, give the alert a webhook_url when you create it.

Authorizations

X-API-KEY
string
header
required

Your API key

Path Parameters

id
string<uuid>
required

UUID of the alert

Query Parameters

since
string<date-time>

ISO 8601 timestamp. Only return runs created at or after this time. Pass the checked_at of your previous call

Response

The alert and its runs

alert
object
required
checked_at
string<date-time>
required

Server time of this call. Pass it as since next time to get only newer runs

searches
object[]
required

Lead runs. Fetch each run's leads from its results_url

lists
object[]
required

Company runs (CUSTOM_ACCOUNT and other alerts that deliver company lists). Fetch each run's companies from its results_url