> ## 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. # Get a post engagement monitor > Retrieve one monitor and its active sources. 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. Retrieve one monitor by `monitor_id` with its active sources, sorted by URL. Each source has `id`, `linkedin_url`, `kind` (`company` or `profile`), `status` (`pending` until its first check, then `monitoring`), `last_checked_at`, and `last_error`. Monitors created in the Airscale app can also contain single-post sources with `kind: "post"`; the API itself only adds company and profile sources. The monitor reports `next_check_at` and `last_checked_at` as ISO 8601 timestamps, or `null`, and `last_error` as a short code when the last check could not complete. `results_status` is `ready`, `pending` (engagers waiting for delivery), or `blocked` with `results_error` such as `insufficient_credits`, `results_table_deleted`, `table_row_limit_reached`, or `results_columns_missing`. ## Next step Use [List engagers](https://docs.airscale.io/api-reference/post-engagement-monitors/engagers.md) to read the people delivered so far. ## OpenAPI ````yaml openapi.json GET /v1/post-engagement-monitors/{monitor_id} 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}: get: tags: - Post engagement monitoring summary: Get a post engagement monitor description: >- Returns one monitor and its active sources. Requires a V2 workspace API key. Legacy V1 API keys are not supported. Monitors and their credits belong to the V2 workspace. operationId: getPostEngagementMonitor parameters: - name: monitor_id in: path required: true schema: type: string format: uuid example: 71111111-1111-4111-8111-111111111111 responses: '200': description: The monitor detail. content: application/json: schema: type: object additionalProperties: false required: - monitor - sources properties: monitor: $ref: '#/components/schemas/PostEngagementMonitor' sources: type: array items: $ref: '#/components/schemas/PostEngagementSource' description: The monitor's active sources, sorted by URL. examples: success: summary: Successful response value: monitor: id: 71111111-1111-4111-8111-111111111111 name: Competitor audiences status: active frequency: daily engagement_types: - reactions - comments include_existing_engagers: false filters: titles: - VP - Head of locations: - France excluded_company_urls: - https://www.linkedin.com/company/example-company results_table_id: 74444444-4444-4444-8444-444444444444 results_status: ready results_error: null next_check_at: '2026-11-03T09:00:00.000Z' last_checked_at: '2026-11-02T09:00:00.000Z' last_error: null webhook_url: https://hooks.example.com/airscale/engagers webhook_configured: true source_count: 2 engager_count: 37 unread_engager_count: 5 created_at: '2026-11-02T08:58:00.000Z' updated_at: '2026-11-02T09:00:00.000Z' sources: - id: 72222222-2222-4222-8222-222222222222 linkedin_url: https://www.linkedin.com/company/example-company kind: company status: monitoring last_checked_at: '2026-11-02T09:00:00.000Z' last_error: null - id: 72222223-2222-4222-8222-222222222223 linkedin_url: https://www.linkedin.com/in/example-person kind: profile status: monitoring last_checked_at: '2026-11-02T09:00:00.000Z' last_error: 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 '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: PostEngagementMonitor: type: object additionalProperties: false required: - id - name - status - frequency - engagement_types - include_existing_engagers - filters - results_table_id - results_status - results_error - next_check_at - last_checked_at - last_error - webhook_url - webhook_configured - source_count - engager_count - unread_engager_count - created_at - updated_at properties: id: type: string format: uuid name: type: string status: type: string enum: - active - paused frequency: type: string enum: - daily - weekly engagement_types: type: array items: type: string enum: - reactions - comments include_existing_engagers: type: boolean filters: type: object additionalProperties: false required: - titles - locations - excluded_company_urls properties: titles: type: array items: type: string locations: type: array items: type: string excluded_company_urls: type: array items: type: string results_table_id: type: string description: >- The Airscale results table that receives one row per delivered engager. results_status: type: string enum: - ready - pending - blocked description: >- ready, pending (engagers waiting for delivery) or blocked (see results_error). results_error: type: - string - 'null' description: >- Why delivery is blocked, for example insufficient_credits, results_table_deleted, table_row_limit_reached or results_columns_missing. next_check_at: type: - string - 'null' format: date-time last_checked_at: type: - string - 'null' format: date-time last_error: type: - string - 'null' description: A short code when the last check could not complete. webhook_url: type: - string - 'null' format: uri webhook_configured: type: boolean source_count: type: integer minimum: 0 description: Active sources. engager_count: type: integer minimum: 0 description: Engagers delivered to the results table. unread_engager_count: type: integer minimum: 0 description: Exact count, independent of any page size. created_at: type: string format: date-time updated_at: type: string format: date-time PostEngagementSource: type: object additionalProperties: false required: - id - linkedin_url - kind - status - last_checked_at - last_error properties: id: type: string format: uuid linkedin_url: type: string kind: type: string enum: - company - profile - post description: >- The API accepts company and profile sources only; post appears on single-post sources added in the Airscale app. status: type: string enum: - pending - monitoring - removed description: >- pending until the source's first check, then monitoring. removed appears only in a remove response. last_checked_at: type: - string - 'null' format: date-time last_error: type: - string - '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 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.