> ## Documentation Index > Fetch the complete documentation index at: https://docs.airscale.io/llms.txt > Use this file to discover all available pages before exploring further. # List post engagers > Read cursor-paginated engagers delivered to the results table, with their webhook delivery receipts. Rate limit: 120 requests per fixed minute per API key, shared by all post engagement monitor endpoints. > [!NOTE] > > 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](https://docs.airscale.io/api-reference/post-engagement-monitors/engagements.md) 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](https://docs.airscale.io/api-reference/post-engagement-monitors/engagers/redeliver.md) to send an engager again. ## Next step Use [Mark an engager as read](https://docs.airscale.io/api-reference/post-engagement-monitors/engagers/read.md) after your application has processed an engager. ## OpenAPI ````yaml openapi.json GET /v1/post-engagement-monitors/{monitor_id}/engagers openapi: 3.1.0 info: title: Airscale Public API version: '2026-09-11' description: >- Search, enrich, resolve public business data, and monitor job changes with Airscale. x-airscale-source-repository: ViceScale/airscale-code x-airscale-source-sha: 1de19e1b70a052a4b8d9c2075021a7e5e7a94d51 servers: - url: https://api.airscale.io description: Production security: - bearerAuth: [] tags: - name: Search and discovery description: Search people, companies, and the web. - name: Contact data description: Find professional and personal contact data. - name: Profiles and reverse lookup description: Extract profiles or resolve a person from known contact data. - name: Post engagement description: Retrieve and enrich people who liked or commented on LinkedIn posts. - name: LinkedIn content description: >- Search LinkedIn posts, read profile and company feeds, and retrieve profile comments and comment reactions. - name: Job change monitoring description: Track LinkedIn profiles and receive job-change events. - name: New hire monitoring description: Watch companies or the market for people who start a matching role. - name: Post engagement monitoring description: >- Follow LinkedIn company pages and profiles and receive the people who engage with their posts. - name: Account description: Inspect workspace account state. - name: Miscellaneous description: >- Find website technologies and check WhatsApp availability, Meta ads, and email deliverability. paths: /v1/post-engagement-monitors/{monitor_id}/engagers: get: tags: - Post engagement monitoring summary: List delivered engagers description: >- Returns cursor-paginated engagers delivered to the results table, newest delivery first, each with its engagement count and webhook delivery receipt. Send next_cursor unchanged on the next request. Requires a V2 workspace API key. Legacy V1 API keys are not supported. Monitors and their credits belong to the V2 workspace. operationId: listPostEngagementMonitorEngagers parameters: - name: monitor_id in: path required: true schema: type: string format: uuid example: 71111111-1111-4111-8111-111111111111 - name: limit in: query required: false description: Number of engagers to return, from 1 to 100. Defaults to 50. schema: type: integer minimum: 1 maximum: 100 default: 50 example: 50 - name: cursor in: query required: false description: Opaque cursor from the preceding response. Send it unchanged. schema: type: string minLength: 1 maxLength: 200 example: eyJ0IjoiMjAyNi0xMS0wMlQwOTowMjowMC4wMDBaIn0 responses: '200': description: The requested engager page. content: application/json: schema: type: object additionalProperties: false required: - engagers - next_cursor properties: engagers: type: array items: $ref: '#/components/schemas/PostEngagementEngager' next_cursor: type: - string - 'null' examples: success: summary: Successful response value: engagers: - id: 73333333-3333-4333-8333-333333333333 monitor_id: 71111111-1111-4111-8111-111111111111 linkedin_url: https://www.linkedin.com/in/example-engager name: Example Engager headline: VP Sales at Example Company title: VP Sales company_name: Example Company company_linkedin_url: https://www.linkedin.com/company/example-company-2 location: Paris, France existing_engager: false engagement_count: 2 first_detected_at: '2026-11-02T09:01:00.000Z' last_detected_at: '2026-11-02T09:01:00.000Z' delivered_at: '2026-11-02T09:02:00.000Z' read_at: null webhook: status: sent attempt_count: 1 last_attempt_at: '2026-11-02T09:02:04.000Z' sent_at: '2026-11-02T09:02:05.000Z' error_code: null next_cursor: null '401': $ref: '#/components/responses/MonitorUnauthorized' '404': description: monitor_not_found in this workspace. content: application/json: schema: $ref: '#/components/schemas/MonitorApiError' examples: error: summary: Error response value: error: code: monitor_not_found message: Monitor not found '422': description: >- invalid_page (limit outside 1–100 or an unknown query parameter) or invalid_cursor. content: application/json: schema: $ref: '#/components/schemas/MonitorApiError' examples: error: summary: Error response value: error: code: invalid_page message: Invalid page '429': description: >- The API key has exceeded 120 requests in the current minute across post engagement monitor endpoints. Wait for the Retry-After seconds before retrying. content: application/json: schema: $ref: '#/components/schemas/Error' examples: error: summary: Error response value: error: Too Many Requests message: 'Rate limit exceeded: 120 requests per minute' headers: Retry-After: description: Seconds to wait before retrying. schema: type: string example: '60' '503': description: >- service_unavailable: post engagement monitoring is temporarily unavailable. content: application/json: schema: $ref: '#/components/schemas/MonitorApiError' components: schemas: PostEngagementEngager: type: object additionalProperties: false required: - id - monitor_id - linkedin_url - name - headline - title - company_name - company_linkedin_url - location - existing_engager - engagement_count - first_detected_at - last_detected_at - delivered_at - read_at - webhook properties: id: type: string format: uuid monitor_id: type: string format: uuid linkedin_url: type: string name: type: - string - 'null' headline: type: - string - 'null' title: type: - string - 'null' company_name: type: - string - 'null' company_linkedin_url: type: - string - 'null' location: type: - string - 'null' existing_engager: type: boolean description: >- true when the person engaged before the monitor existed and was delivered because include_existing_engagers was on. engagement_count: type: integer minimum: 0 first_detected_at: type: string format: date-time last_detected_at: type: string format: date-time delivered_at: type: - string - 'null' format: date-time read_at: type: - string - 'null' format: date-time webhook: description: >- The webhook delivery receipt for this engager, or null when no delivery exists. oneOf: - $ref: '#/components/schemas/MonitorWebhookDelivery' - type: 'null' MonitorApiError: type: object additionalProperties: false required: - error properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string message: type: string Error: type: object additionalProperties: true properties: error: type: string message: type: string MonitorWebhookDelivery: type: object additionalProperties: false required: - status - attempt_count - last_attempt_at - sent_at - error_code properties: status: type: string enum: - pending - sending - retryable - sent - failed - uncertain - cancelled description: >- uncertain means a timeout or dropped connection: the request may have been received. It is never resent automatically. attempt_count: type: integer minimum: 0 last_attempt_at: type: - string - 'null' format: date-time sent_at: type: - string - 'null' format: date-time error_code: type: - string - 'null' description: >- For example webhook_http_410, webhook_url_rejected or webhook_configuration_changed. responses: MonitorUnauthorized: description: >- A missing Bearer token returns {"error":"Unauthorized","message":"Missing or invalid bearer token"}. An unknown API key returns invalid_api_key. content: application/json: schema: oneOf: - $ref: '#/components/schemas/MonitorApiError' - $ref: '#/components/schemas/Error' examples: invalidKey: summary: Unknown API key value: error: code: invalid_api_key message: The API key is not valid securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key description: >- Use an Airscale workspace API key. Never expose the key in client-side code. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.