Endpoint
Query Parameters
string
required
The task ID returned by any LinkedIn API endpoint
Response
boolean
Whether the request was successful
string
The task ID
string
Current task status:
pending or completedobject
The original input you provided when creating the task
object | null
The task result.
null while status is pending, populated when completedStatus Values
Polling Pattern
Since all LinkedIn API tasks are asynchronous, you need to poll this endpoint to get results. Here is the recommended pattern:- Call a LinkedIn API endpoint (e.g.,
fetch-profile) to create a task - Receive the
api_agent_task_idin the response - Poll
get-task-statusevery 5 seconds - Stop polling when
statusiscompleted - Read the results from
task_output
Code Examples
Basic Polling
Polling with Bash Loop
Team Scoping
Task status queries are scoped to your team. You can only retrieve the status of tasks that were created with your API key. Attempting to check a task that belongs to a different team will return a404 error.
Error Responses
FAQ
How often should I poll?
How often should I poll?
We recommend polling every 5 seconds. This provides a good balance between responsiveness and avoiding unnecessary requests. Most tasks complete within 10-60 seconds.
What happens if a task never completes?
What happens if a task never completes?
In rare cases, a task may remain in
pending status if the Chrome extension is not running or encounters an issue. We recommend setting a timeout of 2-3 minutes. If a task has not completed within that window, check that the Chrome extension is active and try creating a new task.Can I check the status of multiple tasks at once?
Can I check the status of multiple tasks at once?
Currently, you can only check one task at a time. If you need to monitor multiple tasks, make separate requests for each task ID.
Do tasks expire?
Do tasks expire?
Task records are persisted in the database. You can check the status of completed tasks at any time to re-read the output.
What task_type values will I see in task_input?
What task_type values will I see in task_input?
The
task_type field in task_input indicates which endpoint created the task:agent_profile_fetch- from Fetch Profileagent_profiles_tracking- from Fetch Postsagent_company_fetch- from Fetch Companyagent_company_tracking- from Fetch Company Postsagent_like_post- from Like Postagent_comment_post- from Comment on Postagent_send_message- from Send Messageagent_search_profiles- from Search Profilesagent_fetch_connections- from Fetch Connections
Related
- Fetch Profile - Creates profile fetch tasks
- Fetch Posts - Creates post fetch tasks
- Fetch Company - Creates company fetch tasks
- Fetch Company Posts - Creates company post fetch tasks
- Like Post - Creates like tasks
- Comment on Post - Creates comment tasks
- Send Message - Creates message send tasks
- Search Profiles - Creates profile search tasks
- Fetch Connections - Creates connection fetch tasks

