Skip to main content
GET
List new hire events
New hire monitoring requires a V2 workspace API key. Legacy V1 API keys are not supported by these endpoints. Monitors and their credits belong to the V2 workspace associated with the key.
List the new hires delivered to the results table for one monitor, newest first. Set limit from 1 to 100 (default 50), filter with type (all, external, internal), and from and to (YYYY-MM-DD, UTC, inclusive). When next_cursor is not null, send it unchanged as cursor with the same filters; a cursor used with different filters returns 422 invalid_event_cursor. Unknown query parameters return 422 invalid_event_page. Each event has hire_type, person (name, linkedin_url, location), title, start_date (the reported start month YYYY-MM, or null), company (name, linkedin_company_id, linkedin_url), previous_title, previous_company_name, detected_at, and read_at. Unknown fields are null. This endpoint is also the durable fallback when webhook delivery is delayed or unavailable.

Webhook delivery receipts

Each event carries a webhook object, or null when no delivery exists. status is pending, sending, retryable, sent, failed, uncertain, or cancelled, with attempt_count, last_attempt_at, sent_at, and error_code (for example webhook_http_410 or webhook_configuration_changed). uncertain means a timeout or dropped connection: the request may have been received. Use Redeliver a webhook to send an event again.

Next step

Use Mark an event as read after your application has processed an event.

Authorizations

Authorization
string
header
required

Use an Airscale workspace API key. Never expose the key in client-side code.

Path Parameters

monitor_id
string<uuid>
required

Query Parameters

limit
integer
default:50

Number of events to return, from 1 to 100. Defaults to 50.

Required range: 1 <= x <= 100
type
enum<string>
default:all

Only external hires, only internal moves, or both.

Available options:
all,
external,
internal
from
string<date>

First detection date to include, YYYY-MM-DD in UTC (inclusive).

to
string<date>

Last detection date to include, YYYY-MM-DD in UTC (inclusive). Must not precede from.

cursor
string

Opaque cursor from the preceding response. It is only valid with the same type, from and to.

Required string length: 1 - 1024

Response

The requested event page.

events
object[]
required
next_cursor
string | null
required