v1

latestOpenAPI 3.1.02026-07-247601.0 MB

Miscellaneous

Poll Webhook Result

This endpoint doesn't consume Apollo credits. Learn more about API pricing and credits.

Use the Poll Webhook Result endpoint to retrieve webhook results from Apollo. This endpoint enables you to poll for the webhook payload if you didn't receive the original webhook callback. To use this endpoint, you need the <code>request_id</code> from the <a href="https://docs.apollo.io/reference/people-enrichment">People Enrichment</a> or <a href="https://docs.apollo.io/reference/bulk-people-enrichment">Bulk People Enrichment</a> endpoint. Pass this value as <code>request_id</code> in this endpoint. This endpoint returns webhook results for your team from up to thirty days after the webhook was triggered.

get/webhook_result/{request_id}

Path parameters

request_idinteger required

The <code>request_id</code> returned when the original enrichment request was submitted. This value is a signed 64-bit integer and can be positive or negative. Example: <code>1039995589705121900</code>

Response

200

request_idstring

Echoes the <code>request_id</code> from the URL.

webhook_status'in_progress' | 'success' | 'failed'

The current webhook status.

request_type'email' | 'phone' | 'waterfall'

The enrichment request type.

last_dispatched_atstring nullable

ISO 8601 UTC timestamp of the last webhook <code>POST</code> attempt. Returns <code>null</code> until Apollo makes the first dispatch attempt.

failure_reasonstring nullable

The error message from the last failed dispatch. This field is populated when <code>webhook_status</code> is <code>failed</code>.

webhook_resultobject nullable

The original webhook payload that Apollo delivered, or would have delivered, to the customer webhook URL. The shape varies by <code>request_type</code>.

Example response

{
  "request_id": "1039995589705121900",
  "webhook_status": "success",
  "request_type": "phone",
  "last_dispatched_at": "2026-05-26T10:42:11Z"
}