Skip to main content
GET
List delivered engagers
Post engagement 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 engagers delivered to the results table for one monitor, newest delivery first. Set limit from 1 to 100 (default 50). Pass the returned next_cursor unchanged as cursor; it is null on the last page. A malformed cursor returns 422 invalid_cursor, and an invalid limit or unknown query parameter returns 422 invalid_page. Each engager has linkedin_url, name, headline, title, company_name, company_linkedin_url, location (each null when unknown), engagement_count, first_detected_at, last_detected_at, delivered_at, and read_at. existing_engager: true marks people imported because include_existing_engagers was on. Use List engagements for the individual reactions and comments.

Webhook delivery receipts

Each engager carries a webhook object, or null when no delivery exists (for example, no webhook was configured when the engager was delivered). 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_405 or webhook_configuration_changed). Use Redeliver a webhook to send an engager again.

Next step

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

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 engagers to return, from 1 to 100. Defaults to 50.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from the preceding response. Send it unchanged.

Required string length: 1 - 200

Response

The requested engager page.

engagers
object[]
required
next_cursor
string | null
required