---
title: "Poll batch live enrichment"
method: POST
path: "/v1/linkedin-live-fetch/batch/poll"
tags: ["Live fetch"]
---

# Poll batch live enrichment

`POST /v1/linkedin-live-fetch/batch/poll`

Polls a batch live enrichment task for progress and results. Returns paginated enrichment results as they complete. Call repeatedly until status is 'completed' or 'failed'.

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

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `taskId` string, required — The batch ID returned from the start endpoint
  - `cursor` string, nullable — Pagination cursor from the previous poll response. Omit for the first request.
  - `take` integer — Number of results per page. Defaults to 100.

## Response `200`

Default Response

- object
  - `output` object, required
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required — Current status of the batch job
    - `type` 'PROFILE' | 'COMPANY', required
    - `progress` object, required
      - `total` integer, required — Total unique identifiers in the batch (excluding duplicates skipped at submission)
      - `completed` integer, required — Number successfully enriched
      - `notFound` integer, required — Number of identifiers not found on LinkedIn
      - `failed` integer, required — Number that failed due to enrichment errors
      - `malformed` integer, required — Number of identifiers that could not be parsed from your input
      - `pending` integer, required — Number still waiting or in progress
    - `results` object[], required — Paginated enrichment results for completed/failed items.
      - `identifier` string, required — The raw identifier that was submitted.
      - `status` 'COMPLETED' | 'FAILED' | 'NOT_FOUND' | 'MALFORMED', required — The enrichment status for this identifier.
      - `profile` object, nullable — Enriched profile data. Present only when type is profile and status is COMPLETED.
        - `articles` object[], nullable
          - `id` string, nullable
          - `title` string, nullable
          - `date_published` string, nullable
        - `certifications` object[], nullable
          - `title` string, nullable
          - `credential_id` string, nullable
          - `verify_url` string, nullable
          - `summary` string, nullable
          - `linkedin_company_id` string, nullable
          - `company_name` string, nullable
          - `date` string, nullable
        - `connection_count` number, nullable
        - `courses` object[], nullable
          - `title` string, nullable
          - `course_number` string, nullable
          - `association` unknown
        - `dob` string, nullable
        - `education` object[], nullable
          - `school_id` string, nullable
          - `school_name` string, nullable
          - `field_of_study_id` string, nullable
          - `field_of_study_name` string, nullable
          - `degree` string, nullable
          - `grade` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `activities` string, nullable
          - `notes` string, nullable
        - `experiences` object[], nullable
          - `linkedin_company_id` string, nullable
          - `is_current` boolean, nullable
          - `company_name` string, nullable
          - `locality` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `summary` string, nullable
          - `title` string, nullable
          - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
          - `job_function` string[], nullable
          - `employment_type` string[], nullable
          - `academic_qualification` string[], nullable
          - `company_start_date` string, nullable
          - `company_end_date` string, nullable
        - `first_name` string, nullable
        - `follower_count` number, nullable
        - `headline` string, nullable
        - `industry_name` string, nullable
        - `inferred_location` object, nullable
          - `street_address` string, nullable
          - `neighborhood` string, nullable
          - `city` string, nullable
          - `state_name` string, nullable
          - `state_code` string, nullable
          - `county` string, nullable
          - `postal_code` string, nullable
          - `country_code` string, nullable
          - `country_name` string, nullable
          - `coordinates` object, nullable
            - `lat` number, required
            - `lon` number, required
          - `timezone` string, nullable
          - `full_address` string, nullable
          - `formatted_address` string, nullable
        - `interests` string[], nullable
        - `last_name` string, nullable
        - `locality` string, nullable
        - `name` string, nullable
        - `patents` object[], nullable
          - `id` string, nullable
          - `title` string, nullable
          - `country` string, nullable
          - `number` string, nullable
          - `description` string, nullable
          - `url` string, nullable
          - `date` string, nullable
        - `profile_pic` string, nullable
        - `projects` object[], nullable
          - `project_id` string, nullable
          - `project_title` string, nullable
          - `project_url` string, nullable
          - `project_summary` string, nullable
          - `is_current` boolean, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
        - `publications` object[], nullable
          - `collaborators` object[], nullable
            - `name` string, nullable
            - `url` string, nullable
          - `date` string, nullable
          - `id` string, nullable
          - `publisher` string, nullable
          - `summary` string, nullable
          - `title` string, nullable
          - `url` string, nullable
        - `skills` string[], nullable
        - `primary_slug` string, required
        - `slugs` string[], nullable
        - `summary` string, nullable
        - `url` string, nullable
        - `user_id` string, nullable
        - `volunteering` object[], nullable
          - `role` string, nullable
          - `is_current` boolean, nullable
          - `cause` string, nullable
          - `summary` string, nullable
          - `linkedin_company_id` string, nullable
          - `company_name` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
        - `tenures` object[], nullable
          - `linkedin_company_id` string, nullable
          - `company_name` string, nullable
          - `date_range` object, required
            - `gte` string, nullable
            - `lte` string, nullable
          - `range_length_days` number, nullable
          - `titles` string[], required
          - `localities` string[], required
        - `career_began_at` string, nullable
        - `tags` string[], nullable
        - `entity_urn` string, nullable
        - `open_to_work` boolean, nullable
        - `premium` boolean, nullable
        - `influencer` boolean, nullable
        - `organizations` object[], nullable
          - `name` string, nullable
          - `end_date` string, nullable
          - `title` string, nullable
          - `start_date` string, nullable
        - `entity_urns` string[], nullable
        - `is_hiring` boolean, nullable
        - `websites` string[], nullable
        - `is_verified` boolean, nullable
        - `verifications` object, nullable
          - `is_verified` boolean, nullable
          - `joined_date` string, nullable
          - `verification_types` object[], nullable
            - `title` string, nullable
            - `subtitle` string, nullable
            - `description` string, nullable
        - `is_top_voice` boolean, nullable
        - `current_job` object, nullable
          - `linkedin_company_id` string, nullable
          - `is_current` boolean, nullable
          - `company_name` string, nullable
          - `locality` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `summary` string, nullable
          - `title` string, nullable
          - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
          - `job_function` string[], nullable
          - `employment_type` string[], nullable
          - `academic_qualification` string[], nullable
          - `company_start_date` string, nullable
          - `company_end_date` string, nullable
        - `custom_data` object, nullable
        - `relevance_score` number, nullable
        - `last_sort_key` string, nullable
        - `last_updated_at` string, nullable
        - `languages` object[], nullable
          - `name` string, nullable
          - `proficiency_id` string, nullable
          - `proficiency_name` string, nullable
        - `detailed_education` object[], nullable
          - `school_details` object, nullable
            - `linkedin_ids` string[], nullable
            - `li_org_id` string, nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `preferred_name` string, nullable
          - `school_id` string, nullable
          - `school_name` string, nullable
          - `field_of_study_id` string, nullable
          - `field_of_study_name` string, nullable
          - `degree` string, nullable
          - `grade` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `activities` string, nullable
          - `notes` string, nullable
        - `detailed_work_experiences` object[], nullable
          - `company_details` object, nullable
            - `linkedin_ids` string[], nullable
            - `li_org_id` string, nullable
            - `linkedin_primary_slug` string, nullable
            - `domains` string[], nullable
            - `preferred_name` string, nullable
          - `crunchbase_slug` string, nullable
          - `linkedin_company_id` string, nullable
          - `is_current` boolean, nullable
          - `company_name` string, nullable
          - `locality` string, nullable
          - `start_date` string, nullable
          - `end_date` string, nullable
          - `summary` string, nullable
          - `title` string, nullable
          - `seniority` 'Entry level' | 'Director' | 'Associate' | 'Mid-Senior level' | 'Internship' | 'Executive' | 'null', nullable
          - `job_function` string[], nullable
          - `employment_type` string[], nullable
          - `academic_qualification` string[], nullable
          - `company_start_date` string, nullable
          - `company_end_date` string, nullable
      - `company` object, nullable — Enriched company data. Present only when type is company and status is COMPLETED.
        - `headline` string, nullable
        - `description` string, nullable
        - `employee_count` number, nullable
        - `follower_count` number, nullable
        - `founded_year` number, nullable
        - `industries` object[], nullable
          - `id` string, required
          - `name` string, required
          - `primary` boolean, nullable
        - `inferred_location` object, nullable
          - `street_address` string, nullable
          - `neighborhood` string, nullable
          - `city` string, nullable
          - `state_name` string, nullable
          - `state_code` string, nullable
          - `county` string, nullable
          - `postal_code` string, nullable
          - `country_code` string, nullable
          - `country_name` string, nullable
          - `coordinates` object, nullable
            - `lat` number, required
            - `lon` number, required
          - `timezone` string, nullable
          - `full_address` string, nullable
          - `formatted_address` string, nullable
        - `linkedin_url` string, nullable
        - `locations` object[], nullable
          - `address` string, nullable
          - `is_primary` boolean, nullable
          - `location` object, nullable
            - `street_address` string, nullable
            - `neighborhood` string, nullable
            - `city` string, nullable
            - `state_name` string, nullable
            - `state_code` string, nullable
            - `county` string, nullable
            - `postal_code` string, nullable
            - `country_code` string, nullable
            - `country_name` string, nullable
            - `coordinates` object, nullable
              - …
            - `timezone` string, nullable
            - `full_address` string, nullable
            - `formatted_address` string, nullable
        - `naics_codes` string[], nullable
        - `name` string, nullable
        - `org_id` string, nullable
        - `slug` string, required
        - `specialties` string[], nullable
        - `ticker` string, nullable
        - `type` string, nullable
        - `domain` string, nullable
        - `website` string, nullable
        - `est_employee_count_lower_bound` number, nullable
        - `est_employee_count_upper_bound` number, nullable
        - `standardized_industries` string[], nullable
        - `locations_stats` object, nullable
          - `USA` number
          - `GBR` number
          - `FRA` number
          - `IND` number
          - `BRA` number
          - `DEU` number
          - `ESP` number
          - `CAN` number
          - `AUS` number
          - `NLD` number
          - `ITA` number
          - `ZAF` number
          - `BEL` number
          - `CHN` number
          - `TUR` number
          - `MEX` number
          - `CHE` number
          - `NOR` number
          - `ARE` number
          - `SWE` number
          - `POL` number
          - `IDN` number
          - `ARG` number
          - `PRT` number
          - `COL` number
          - `CHL` number
          - `PAK` number
          - `DNK` number
          - `JPN` number
          - `NGA` number
          - `SGP` number
          - `PER` number
          - `NZL` number
          - `AUT` number
          - `IRL` number
          - `MYS` number
          - `BGD` number
          - `EGY` number
          - `ISR` number
          - `SAU` number
          - `PHL` number
          - `FIN` number
          - `IRN` number
          - `ROU` number
          - `CZE` number
          - `GRC` number
          - `HKG` number
          - `HUN` number
          - `KEN` number
          - `MAR` number
          - `VNM` number
          - `RUS` number
          - `UKR` number
          - `ECU` number
          - `THA` number
          - `LKA` number
          - `KOR` number
          - `BGR` number
          - `GHA` number
          - `SRB` number
          - `TWN` number
          - `HRV` number
          - `LTU` number
          - `PRI` number
          - `SVK` number
          - `TUN` number
          - `EST` number
          - `VEN` number
          - `CRI` number
          - `PAN` number
          - `URY` number
          - `LBN` number
          - `LUX` number
          - `CYP` number
          - `NPL` number
          - `JOR` number
          - `SVN` number
          - `MTQ` number
          - `QAT` number
          - `GLP` number
          - `UGA` number
          - `DZA` number
          - `GTM` number
          - `CMR` number
          - `LVA` number
          - `DOM` number
          - `AZE` number
          - `GEO` number
          - `SEN` number
          - `TZA` number
          - `ZWE` number
          - `KWT` number
          - `MLT` number
          - `OMN` number
          - `BOL` number
          - `SLV` number
          - `ARM` number
          - `PRY` number
          - `IRQ` number
          - `KHM` number
          - `BIH` number
          - `AGO` number
          - `BHR` number
          - `ALB` number
          - `KAZ` number
          - `CIV` number
          - `ETH` number
          - `MUS` number
          - `ZMB` number
          - `MKD` number
          - `COD` number
          - `BLR` number
          - `MOZ` number
          - `REU` number
          - `TTO` number
          - `GUF` number
          - `ISL` number
          - `MMR` number
          - `HND` number
          - `RWA` number
          - `MDG` number
          - `BEN` number
          - `UZB` number
          - `NAM` number
          - `BWA` number
          - `MDA` number
          - `JEY` number
          - `NIC` number
          - `SDN` number
          - `JAM` number
          - `IMN` number
          - `BFA` number
          - `MNG` number
          - `MNE` number
          - `MCO` number
          - `TGO` number
          - `AFG` number
          - `LBY` number
          - `XKX` number
          - `CYM` number
          - `MWI` number
          - `SOM` number
          - `PNG` number
          - `MDV` number
          - `MLI` number
          - `GIN` number
          - `PSE` number
          - `GAB` number
          - `LIE` number
          - `HTI` number
          - `SYR` number
          - `BRB` number
          - `YEM` number
          - `GGY` number
          - `NCL` number
          - `AND` number
          - `SUR` number
          - `MYT` number
          - `KGZ` number
          - `BHS` number
          - `GIB` number
          - `COG` number
          - `FJI` number
          - `BLM` number
          - `CUW` number
          - `CUB` number
          - `SLE` number
          - `BLZ` number
          - `NER` number
          - `LBR` number
          - `VIR` number
          - `PYF` number
          - `GUM` number
          - `MRT` number
          - `ABW` number
          - `SYC` number
          - `GUY` number
          - `LSO` number
          - `SWZ` number
          - `SSD` number
          - `LCA` number
          - `MAC` number
          - `SMR` number
          - `LAO` number
          - `BRN` number
          - `TCD` number
          - `BMU` number
          - `VGB` number
          - `PRK` number
          - `BTN` number
          - `BDI` number
          - `FRO` number
          - `TJK` number
          - `GMB` number
          - `STP` number
          - `ANT` number
          - `VCT` number
          - `DJI` number
          - `CPV` number
          - `TKM` number
          - `ATG` number
          - `TCA` number
          - `KNA` number
          - `GRD` number
          - `ASM` number
          - `VUT` number
          - `GNQ` number
          - `GRL` number
          - `SXM` number
          - `MNP` number
          - `COM` number
          - `TLS` number
          - `SJM` number
          - `CAF` number
          - `DMA` number
          - `MAF` number
          - `WSM` number
          - `BES` number
          - `MHL` number
          - `AIA` number
          - `TON` number
          - `COK` number
          - `SLB` number
          - `SPM` number
          - `GNB` number
          - `ATA` number
          - `TUV` number
          - `ALA` number
          - `IOT` number
          - `ERI` number
          - `PLW` number
          - `FSM` number
          - `NRU` number
          - `PCN` number
          - `FLK` number
          - `MSR` number
          - `VAT` number
          - `KIR` number
          - `SHN` number
          - `NIU` number
          - `WLF` number
          - `HMD` number
          - `CXR` number
          - `NFK` number
          - `ATF` number
          - `CCK` number
          - `SGS` number
          - `BVT` number
          - `UMI` number
          - `ESH` number
          - `TKL` number
          - `X-SOUTH_ASIA` number
          - `X-SOUTH_EAST_EUROPE` number
          - `X-NORTHERN_AFRICA` number
          - `X-PACIFIC` number
          - `X-SOUTH_WEST_EUROPE` number
          - `X-SOUTHERN_AFRICA` number
          - `X-WEST_INDIES` number
          - `X-SOUTH_AMERICA` number
          - `X-SOUTH_WEST_ASIA` number
          - `X-CENTRAL_EUROPE` number
          - `X-EASTERN_EUROPE` number
          - `X-WESTERN_EUROPE` number
          - `X-CENTRAL_AMERICA` number
          - `X-WESTERN_AFRICA` number
          - `X-SOUTH_ATLANTIC_OCEAN` number
          - `X-SOUTH_EAST_ASIA` number
          - `X-CENTRAL_AFRICA` number
          - `X-NORTH_AMERICA` number
          - `X-EAST_ASIA` number
          - `X-NORTHERN_EUROPE` number
          - `X-EASTERN_AFRICA` number
          - `X-SOUTHERN_INDIAN_OCEAN` number
          - `X-SOUTHERN_EUROPE` number
          - `X-CENTRAL_ASIA` number
          - `X-NORTHERN_ASIA` number
          - `X-ASIA` number
          - `X-EUROPE` number
          - `X-AFRICA` number
          - `X-OCEANIA` number
          - `X-AMERICAS` number
          - `X-ANTARCTICA` number
          - `X-ATLANTIC_OCEAN` number
          - `X-INDIAN_OCEAN` number
          - `X-MIDDLE_EAST` number
          - `X-MENA` number
          - `X-EMEA` number
          - `X-EUROPEAN_UNION` number
          - `X-EFTA` number
          - `X-APAC` number
          - `X-LATAM` number
          - `X-ANGLOSPHERE` number
          - `X-DACH` number
          - `X-NORDICS` number
          - `X-BENELUX` number
          - `X-GCC` number
          - `X-BRICS` number
          - `X-G20` number
          - `X-OECD` number
          - `X-SANCTIONED` number
        - `logo_url` string, nullable
        - `historical_headcount` object, nullable
          - `latest_snapshot_date` string, date, required
          - `snapshots` object[], required
            - `date` string, date, required
            - `employees` integer, required
          - `growth` object, required
            - `1m` object, nullable
              - …
            - `2m` object, nullable
              - …
            - `3m` object, nullable
              - …
            - `6m` object, nullable
              - …
            - `12m` object, nullable
              - …
            - `18m` object, nullable
              - …
            - `24m` object, nullable
              - …
            - `36m` object, nullable
              - …
        - `revenue_usd_lower_bound` string, nullable
        - `revenue_usd_upper_bound` string, nullable
    - `nextCursor` string, nullable — Pagination cursor for the next page. Null when no more results.
    - `completedAt` string, date-time, nullable — ISO timestamp of when the batch completed, if done
  - `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/versions/0c537984b99f/schema)