---
title: "Poll batch contact details"
method: POST
path: "/v1/contact-details/batch/poll"
tags: ["Contact details"]
---

# Poll batch contact details

`POST /v1/contact-details/batch/poll`

Polls a batch contact details task. Returns partial results as they complete. Call this endpoint repeatedly until the 'done' field is true. Use the task ID returned from the 'Start batch contact details' endpoint.

<span>⚡ <strong>Rate limit:</strong> 240 requests per 1 minute</span>

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `taskId` string, required — The task ID from the start endpoint response.
  - `cursor` string, nullable — The pagination cursor from the previous poll response. Omit for the first request.
  - `take` integer — The number of people to return per page. Defaults to 100.

## Response `200`

Default Response

- object
  - `output` object, required
    - `overallStats` object, required — The overall statistics for the batch enrichment task.
      - `totalPeopleToFetch` integer, required — The total number of people in this batch task.
      - `numCompleted` integer, required — The number of people for which contact reveal has completed successfully.
      - `numFailed` integer, required — The number of people for which enrichment failed (no data found or error occurred).
      - `numRemaining` integer, required — The number of people currently being processed (in progress).
      - `numRejected` integer, required — The number of people rejected before queueing because healing failed (for example, an invalid or unresolvable LinkedIn URL).
      - `numDuplicates` integer, required — The number of duplicates found in the input.
    - `done` boolean, required — Whether the batch task has finished. When true, check the 'failed' field to determine if it completed successfully or failed.
    - `failed` boolean, required — Whether the batch task failed. If true, the task encountered an error and won't be retried. If false and done=true, the task completed successfully or was cancelled (check the 'canceled' field). If done=false, this field indicates current processing state.
    - `canceled` boolean, required — Whether the batch task was cancelled. When true, unclaimed profiles were not processed and credits were refunded.
    - `pageResults` object[], required — The array of results for each person in the current page.
      - `inputs` object, required — The input details provided for this person.
        - `linkedinUrl` object, required
          - `value` string, required — A LinkedIn URL, like 'https://www.linkedin.com/in/jake'
      - `outputs` object, nullable — The reveal result for this person.
        - `emails` object[], required
          - `email` string, required
          - `type` 'work' | 'personal' | 'other' | 'unknown' | 'generic', required
          - `status` 'valid' | 'risky' | 'unknown' | 'invalid'
        - `phoneNumbers` object[], required
          - `number` string, required
          - `type` 'mobile' | 'other' | 'unknown', required
        - `exhaustive` boolean, nullable
    - `nextCursor` string, nullable — The pagination cursor for the next page of results.
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/revisions/0c537984b99f/schema)