--- title: "Poll async task" method: GET path: "/v2/webhooks/{webhookId}" tags: ["Webhooks"] --- # Poll async task `GET /v2/webhooks/{webhookId}` ## Request - Base URL: `https://api.reversecontact.com` - URL: `https://api.reversecontact.com/v2/webhooks/{webhookId}` - Auth: HTTP bearer Returns the status and result of an async task created by the live or contact endpoints. When status is succeeded, data.result contains the task result. With wait=N (0 to 20), the request is held up to N seconds while the task is running and answers as soon as the result is ready; it may also answer earlier with the task still in progress. While the task is not finished, the response carries Retry-After: 2; poll again no sooner than that. Credits: 0 (free). Does not increment per-minute rate limit counters. ## Path parameters - `webhookId` string, uuid, required: Task identifier returned as webhookId ## Query parameters - `wait` integer: Long-poll: seconds to hold the request while the task is still running (0 to 20). Absent or 0 answers immediately. Out of range or not an integer: 422 VALIDATION_ERROR. ## Response `200` Task status and optional result - object - `success` true, required - `data` PollWebhookData, required - `webhookId` string, required: Task identifier - `status` 'created' | 'in_progress' | 'succeeded' | 'errored', required: Task status. created and in_progress are not final; succeeded and errored are. - `eventType` 'FETCH_PERSON_DATA' | 'FETCH_COMPANY_DATA' | 'FETCH_ACTIVITY_DATA' | 'FETCH_CONTACT_DATA', required: Kind of task - `errorCode` string, nullable, required: Why the task failed (for example email-not-found); null unless status is errored - `deliveryStatus` string, nullable, required: Set when the result was fetched but the push to your webhookUrl failed (webhook-url-invalid, webhook-url-errored, webhook-url-timeout or webhook-url-unreachable). status stays succeeded and result stays available. - `createdAt` string, date-time, required: When the task was created (ISO 8601) - `result` unknown, required - `creditsConsumed` number, required: Credits charged for the task, net of refunds: 0 while the task runs, final once it succeeded or errored - `error` unknown, required - `quotas` V2Quotas, required - `creditsConsumed` number, required: Credits used for this request after pricing resolution - `workspace` object, required - `id` string, required: Workspace identifier - `credits` V2Credits, required - `total` number, required: Total credits in your plan - `used` number, required: Credits consumed so far - `left` number, required: Remaining credits - `hasUnlimitedCredits` boolean, required: Whether workspace credits are unlimited - `allowDailyOvercost` boolean, required: Whether the workspace may exceed its daily cap (Enterprise only) - `dailyLimit` V2LimitInfo - `limit` integer, required: Maximum allowed in the window - `used` integer, required: Amount used in the window - `left` integer, required: Remaining in the window - `nextReset` string, required: When the window resets (ISO 8601) - `minuteRateLimit` V2LimitInfo, required - `limit` integer, required: Maximum allowed in the window - `used` integer, required: Amount used in the window - `left` integer, required: Remaining in the window - `nextReset` string, required: When the window resets (ISO 8601) - `key` object, nullable, required - `id` string, required: API key identifier - `dailyLimit` V2LimitInfo - `limit` integer, required: Maximum allowed in the window - `used` integer, required: Amount used in the window - `left` integer, required: Remaining in the window - `nextReset` string, required: When the window resets (ISO 8601) - `minuteRateLimit` V2LimitInfo, required - `limit` integer, required: Maximum allowed in the window - `used` integer, required: Amount used in the window - `left` integer, required: Remaining in the window - `nextReset` string, required: When the window resets (ISO 8601) - `creditLimits` object, required: Credit limits set on this API key. Each is null when the key has no such limit. - `daily` V2KeyCreditLimit, required - `limit` number, required: Credits this key may spend in the period - `used` number, required: Credits this key spent in the period, this request included - `left` number, required: Credits this key may still spend in the period - `nextReset` string, nullable, required: When the period resets (ISO 8601): 00:00 UTC for the daily limit, the 1st of next month at 00:00 UTC for the monthly limit, null for the total limit - `monthly` V2KeyCreditLimit, required - `limit` number, required: Credits this key may spend in the period - `used` number, required: Credits this key spent in the period, this request included - `left` number, required: Credits this key may still spend in the period - `nextReset` string, nullable, required: When the period resets (ISO 8601): 00:00 UTC for the daily limit, the 1st of next month at 00:00 UTC for the monthly limit, null for the total limit - `total` V2KeyCreditLimit, required - `limit` number, required: Credits this key may spend in the period - `used` number, required: Credits this key spent in the period, this request included - `left` number, required: Credits this key may still spend in the period - `nextReset` string, nullable, required: When the period resets (ISO 8601): 00:00 UTC for the daily limit, the 1st of next month at 00:00 UTC for the monthly limit, null for the total limit - `metadata` V2Metadata, required - `requestId` string, required: Unique identifier for this request - `executionTimeMs` integer, required: Total execution time in milliseconds - `updatedAt` string: Last upstream update timestamp (ISO 8601). Present only when available. ## Other responses - `400`: Invalid JSON body or endpoint-specific business validation - `401`: Missing or invalid API key or OAuth access token - `402`: No credits left. Purchase more to continue. - `403`: Forbidden: the API key lacks permission for this endpoint, or reached its total credit limit (KEY_CREDIT_LIMIT_REACHED, no reset: raise or reset the limit) - `404`: Data not found - `422`: Schema or validation error, unresolved internal id, or disposable email domain - `429`: Rate limit exceeded, or the API key reached its daily or monthly credit limit (KEY_CREDIT_LIMIT_REACHED). Wait error.details.retryAfter seconds, then retry. The response carries no quotas object. - `451`: Data subject blocked. The profile has been removed per GDPR/CCPA data subject request. --- [API](https://skmtc.dev/scrapin/apis/reverse-contact-api.md) - [All operations](https://skmtc.dev/scrapin/apis/reverse-contact-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrapin/apis/reverse-contact-api/revisions/7d02242af2a9?raw)