> **For AI agents:** this page is a focused, LLM-optimized view of a > single Fiber AI operation. Before calling it, fetch the routing > instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation > index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md). # pollBatchLiveEnrich `POST /v1/linkedin-live-fetch/batch/poll` **Tags:** `Live fetch` Poll batch live enrichment **Endpoint:** `https://api.fiber.ai/v1/linkedin-live-fetch/batch/poll` ## Description 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'. For profile batches, pass `getDetailedEducation`/`getDetailedWorkExperience` on a given poll call to include deep education/work-experience details in that page's results; this slows the call down, so only enable it if you need it. ⚡ Rate limit: 360 requests per 1 minute ## Request body (JSON Schema) ```json { "type": "object", "properties": { "apiKey": { "type": "string", "description": "Your Fiber API key" }, "taskId": { "type": "string", "minLength": 1, "description": "The batch ID returned from the start endpoint" }, "cursor": { "type": [ "string", "null" ], "description": "Pagination cursor from the previous poll response. Omit for the first request." }, "take": { "type": "integer", "exclusiveMinimum": 0, "maximum": 100, "default": 100, "description": "Number of results per page. Defaults to 100." }, "getDetailedEducation": { "type": [ "boolean", "null" ], "default": false, "description": "Whether to include deep details about each educational item, like the school's LinkedIn URL, website, location, etc. That'll be put in the detailedEducation array. This slows down the API call, so only enable this if you need it." }, "getDetailedWorkExperience": { "type": [ "boolean", "null" ], "default": false, "description": "Whether to include deep details about each work experience item, like the company's LinkedIn URL, website, location, etc. That'll be put in the detailedWorkExperience array. This slows down the API call, so only enable this if you need it." } }, "required": [ "apiKey", "taskId" ] } ``` ## Response — success (JSON Schema) ```json { "type": "object", "properties": { "output": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "PENDING", "PROCESSING", "COMPLETED", "FAILED" ], "description": "Current status of the batch job" }, "type": { "type": "string", "enum": [ "PROFILE", "COMPANY" ] }, "progress": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0, "description": "Total unique identifiers in the batch (excluding duplicates skipped at submission)" }, "completed": { "type": "integer", "minimum": 0, "description": "Number successfully enriched" }, "notFound": { "type": "integer", "minimum": 0, "description": "Number of identifiers not found on LinkedIn" }, "failed": { "type": "integer", "minimum": 0, "description": "Number that failed due to enrichment errors" }, "malformed": { "type": "integer", "minimum": 0, "description": "Number of identifiers that could not be parsed from your input" }, "pending": { "type": "integer", "minimum": 0, "description": "Number still waiting or in progress" } }, "required": [ "total", "completed", "notFound", "failed", "malformed", "pending" ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "identifier": { "type": "string", "description": "The raw identifier that was submitted." }, "status": { "type": "string", "enum": [ "COMPLETED", "FAILED", "NOT_FOUND", "MALFORMED" ], "description": "The enrichment status for this identifier." }, "profile": { "type": [ "object", "null" ], "properties": { "articles": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "date_published": { "type": [ "string", "null" ] } } } }, "certifications": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "title": { "type": [ "string", "null" ] }, "credential_id": { "type": [ "string", "null" ] }, "verify_url": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "linkedin_company_id": { "type": [ "string", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] } } } }, "connection_count": { "type": [ "number", "null" ] }, "courses": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "title": { "type": [ "string", "null" ] }, "course_number": { "type": [ "string", "null" ] }, "association": { "type": "null" } } } }, "dob": { "type": [ "string", "null" ] }, "education": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "school_id": { "type": [ "string", "null" ] }, "school_name": { "type": [ "string", "null" ] }, "field_of_study_id": { "type": [ "string", "null" ] }, "field_of_study_name": { "type": [ "string", "null" ] }, "degree": { "type": [ "string", "null" ] }, "grade": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "activities": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } } } }, "experiences": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "linkedin_company_id": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "locality": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "seniority": { "type": [ "string", "null" ], "enum": [ "Entry level", "Director", "Associate", "Mid-Senior level", "Internship", "Executive", null ] }, "job_function": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Arts and Design", "Business Development", "Community & Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Military & Protective Services", "Operations", "Program & Product Management", "Real Estate", "Sales", "Support", "Administrative", "Finance", "Marketing", "Purchasing", "Product Management", "Advertising", "Analyst", "Customer Service", "Distribution", "Design", "General Business", "Management", "Manufacturing", "Other", "Public Relations", "Project Management", "Production", "Quality Assurance", "Research", "Science", "Supply Chain", "Training", "Health Care Provider", "Accounting", "Art / Creative", "Strategy / Planning", "Writing / Editing" ] } }, "employment_type": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Full-time", "Temporary", "Internship", "Contract", "Part-time", "Volunteer", "Other" ] } }, "academic_qualification": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "High School", "Associate Degree", "Bachelor Degree" ] } }, "company_start_date": { "type": [ "string", "null" ] }, "company_end_date": { "type": [ "string", "null" ] } } } }, "first_name": { "type": [ "string", "null" ] }, "follower_count": { "type": [ "number", "null" ] }, "headline": { "type": [ "string", "null" ] }, "inferred_location": { "type": [ "object", "null" ], "properties": { "street_address": { "type": [ "string", "null" ] }, "neighborhood": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "state_name": { "type": [ "string", "null" ] }, "state_code": { "type": [ "string", "null" ] }, "county": { "type": [ "string", "null" ] }, "postal_code": { "type": [ "string", "null" ] }, "country_code": { "type": [ "string", "null" ] }, "country_name": { "type": [ "string", "null" ] }, "coordinates": { "type": [ "object", "null" ], "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "required": [ "lat", "lon" ] }, "timezone": { "type": [ "string", "null" ] }, "full_address": { "type": [ "string", "null" ] }, "formatted_address": { "type": [ "string", "null" ] } } }, "interests": { "type": [ "array", "null" ], "items": { "type": "string" } }, "last_name": { "type": [ "string", "null" ] }, "locality": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "patents": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "number": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "date": { "type": [ "string", "null" ] } } } }, "profile_pic": { "type": [ "string", "null" ] }, "projects": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "project_id": { "type": [ "string", "null" ] }, "project_title": { "type": [ "string", "null" ] }, "project_url": { "type": [ "string", "null" ] }, "project_summary": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] } } } }, "publications": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "collaborators": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } } } }, "date": { "type": [ "string", "null" ] }, "id": { "type": [ "string", "null" ] }, "publisher": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } } } }, "skills": { "type": [ "array", "null" ], "items": { "type": "string" } }, "primary_slug": { "type": "string" }, "slugs": { "type": [ "array", "null" ], "items": { "type": "string" } }, "summary": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] }, "user_id": { "type": [ "string", "null" ] }, "volunteering": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "role": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "cause": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "linkedin_company_id": { "type": [ "string", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] } } } }, "tenures": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "linkedin_company_id": { "type": [ "string", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "date_range": { "type": "object", "properties": { "gte": { "type": [ "string", "null" ] }, "lte": { "type": [ "string", "null" ] } } }, "range_length_days": { "type": [ "number", "null" ] }, "titles": { "type": "array", "items": { "type": "string" } }, "localities": { "type": "array", "items": { "type": "string" } } }, "required": [ "date_range", "titles", "localities" ] } }, "career_began_at": { "type": [ "string", "null" ] }, "tags": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "student", "attended-top-us-university", "attended-top-global-university", "second-time-founder", "deep-technical-background", "major-tech-company-experience", "fortune-500-executive", "recently-changed-companies", "recently-promoted", "decision-maker", "c-suite", "experienced-executive", "phd", "influencer", "board-member" ] } }, "entity_urn": { "type": [ "string", "null" ] }, "open_to_work": { "type": [ "boolean", "null" ] }, "premium": { "type": [ "boolean", "null" ] }, "influencer": { "type": [ "boolean", "null" ] }, "organizations": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] } } } }, "entity_urns": { "type": [ "array", "null" ], "items": { "type": "string" } }, "is_hiring": { "type": [ "boolean", "null" ] }, "websites": { "type": [ "array", "null" ], "items": { "type": "string" } }, "is_verified": { "type": [ "boolean", "null" ] }, "verifications": { "type": [ "object", "null" ], "properties": { "is_verified": { "type": [ "boolean", "null" ] }, "joined_date": { "type": [ "string", "null" ] }, "verification_types": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "title": { "type": [ "string", "null" ] }, "subtitle": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] } } } } } }, "is_top_voice": { "type": [ "boolean", "null" ] }, "current_job": { "type": [ "object", "null" ], "properties": { "linkedin_company_id": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "locality": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "seniority": { "type": [ "string", "null" ], "enum": [ "Entry level", "Director", "Associate", "Mid-Senior level", "Internship", "Executive", null ] }, "job_function": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Arts and Design", "Business Development", "Community & Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Military & Protective Services", "Operations", "Program & Product Management", "Real Estate", "Sales", "Support", "Administrative", "Finance", "Marketing", "Purchasing", "Product Management", "Advertising", "Analyst", "Customer Service", "Distribution", "Design", "General Business", "Management", "Manufacturing", "Other", "Public Relations", "Project Management", "Production", "Quality Assurance", "Research", "Science", "Supply Chain", "Training", "Health Care Provider", "Accounting", "Art / Creative", "Strategy / Planning", "Writing / Editing" ] } }, "employment_type": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Full-time", "Temporary", "Internship", "Contract", "Part-time", "Volunteer", "Other" ] } }, "academic_qualification": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "High School", "Associate Degree", "Bachelor Degree" ] } }, "company_start_date": { "type": [ "string", "null" ] }, "company_end_date": { "type": [ "string", "null" ] } } }, "custom_data": { "type": [ "object", "null" ], "additionalProperties": { "type": "string" } }, "relevance_score": { "type": [ "number", "null" ] }, "last_sort_key": { "type": [ "string", "null" ] }, "industry_name": { "type": [ "string", "null" ] }, "last_updated_at": { "type": [ "string", "null" ] }, "languages": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "proficiency_id": { "type": [ "string", "null" ] }, "proficiency_name": { "type": [ "string", "null" ] } } } }, "detailed_education": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "school_details": { "type": [ "object", "null" ], "properties": { "linkedin_ids": { "type": [ "array", "null" ], "items": { "type": "string" } }, "li_org_id": { "type": [ "string", "null" ] }, "linkedin_primary_slug": { "type": [ "string", "null" ] }, "domains": { "type": [ "array", "null" ], "items": { "type": "string" } }, "preferred_name": { "type": [ "string", "null" ] } } }, "school_id": { "type": [ "string", "null" ] }, "school_name": { "type": [ "string", "null" ] }, "field_of_study_id": { "type": [ "string", "null" ] }, "field_of_study_name": { "type": [ "string", "null" ] }, "degree": { "type": [ "string", "null" ] }, "grade": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "activities": { "type": [ "string", "null" ] }, "notes": { "type": [ "string", "null" ] } } } }, "detailed_work_experiences": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "company_details": { "type": [ "object", "null" ], "properties": { "linkedin_ids": { "type": [ "array", "null" ], "items": { "type": "string" } }, "li_org_id": { "type": [ "string", "null" ] }, "linkedin_primary_slug": { "type": [ "string", "null" ] }, "domains": { "type": [ "array", "null" ], "items": { "type": "string" } }, "preferred_name": { "type": [ "string", "null" ] }, "crunchbase_slug": { "type": [ "string", "null" ] }, "logo_url": { "type": [ "string", "null" ] }, "standard_industries": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Administrative Services", "Aerospace & Military", "Artificial Intelligence", "Arts & Music", "Automotive", "Business Services", "Cloud", "Construction", "Consulting", "Consumer Goods", "Consumer Services", "Design", "Education", "Energy", "Entertainment", "Environmental", "Events", "Farming & Agriculture", "Finance", "Food & Beverage", "Gaming", "Government", "Hardware", "Healthcare", "Hospitality", "Industrials", "Information Technology", "Insurance", "Legal", "Life Sciences", "Logistics", "Manufacturing", "Marketing & Advertising", "Media", "Mining", "Nonprofit", "Publishing", "Real Estate", "Retail", "Science & Engineering", "Security", "Software", "Sports", "Telecom", "Trade", "Transportation", "Travel & Tourism", "Utilities", "Venture Capital" ] } }, "li_industries": { "type": [ "array", "null" ], "items": { "type": "string" } } } }, "linkedin_company_id": { "type": [ "string", "null" ] }, "is_current": { "type": [ "boolean", "null" ] }, "company_name": { "type": [ "string", "null" ] }, "locality": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ] }, "end_date": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "seniority": { "type": [ "string", "null" ], "enum": [ "Entry level", "Director", "Associate", "Mid-Senior level", "Internship", "Executive", null ] }, "job_function": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Arts and Design", "Business Development", "Community & Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Military & Protective Services", "Operations", "Program & Product Management", "Real Estate", "Sales", "Support", "Administrative", "Finance", "Marketing", "Purchasing", "Product Management", "Advertising", "Analyst", "Customer Service", "Distribution", "Design", "General Business", "Management", "Manufacturing", "Other", "Public Relations", "Project Management", "Production", "Quality Assurance", "Research", "Science", "Supply Chain", "Training", "Health Care Provider", "Accounting", "Art / Creative", "Strategy / Planning", "Writing / Editing" ] } }, "employment_type": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Full-time", "Temporary", "Internship", "Contract", "Part-time", "Volunteer", "Other" ] } }, "academic_qualification": { "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "High School", "Associate Degree", "Bachelor Degree" ] } }, "company_start_date": { "type": [ "string", "null" ] }, "company_end_date": { "type": [ "string", "null" ] } } } } }, "required": [ "primary_slug" ], "description": "Enriched profile data. Present only when type is profile and status is COMPLETED." }, "company": { "type": [ "object", "null" ], "properties": { "headline": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "employee_count": { "type": [ "number", "null" ] }, "follower_count": { "type": [ "number", "null" ] }, "founded_year": { "type": [ "number", "null" ] }, "industries": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "primary": { "type": [ "boolean", "null" ] } }, "required": [ "id", "name" ] } }, "inferred_location": { "type": [ "object", "null" ], "properties": { "street_address": { "type": [ "string", "null" ] }, "neighborhood": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "state_name": { "type": [ "string", "null" ] }, "state_code": { "type": [ "string", "null" ] }, "county": { "type": [ "string", "null" ] }, "postal_code": { "type": [ "string", "null" ] }, "country_code": { "type": [ "string", "null" ] }, "country_name": { "type": [ "string", "null" ] }, "coordinates": { "type": [ "object", "null" ], "properties": { "lat": { "type": "number" }, "lon": { "type": "number" } }, "required": [ "lat", "lon" ] }, … _truncated to 65536 chars for ai-docs._ ``` --- Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json) Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)