Get Run Tasks
Retrieve a list of all tasks executed within a specific run
https://api.lobstr.io/v1/runtasksThis endpoint retrieves a paginated list of all tasks executed within a specific run, including their individual status, results, and parameters.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| run | string | Yes | The run hash ID to get tasks for |
| page | integer | No | Page number for pagination. Default: 1 |
| limit | integer | No | Results per page. Default: 50, Max: 100 |
Response Field Explanations
total_resultsintegerTotal number of run tasks. Example: 1
dataarrayArray of run task objects. Example: [...]
data[].idstringUnique run task identifier. Example: "1262f6f99dac7dffb05a513fff0ded77"
data[].objectstringAlways "runtask". Example: "runtask"
data[].taskstringOriginal task identifier. Example: "d30334cd8d21ab16048c5e2e7136a9f1"
data[].runstringParent run identifier. Example: "300e9c5c127d421c90f431478d9a2cfb"
data[].statusstringTask execution status (completed, aborted, error, etc.). Example: "aborted"
data[].paramsobjectTask parameters. Example: {"url": "https://..."}
data[].started_atstringWhen task execution started. Example: "2025-02-10T14:30:58Z"
data[].ended_atstringWhen task execution ended. Example: "2025-02-10T14:31:10Z"
data[].total_resultsintegerTotal results expected from this task. Example: 138
data[].last_resultintegerNumber of results actually collected. Example: 6
data[].total_pagesintegerTotal pages processed. Example: 1
data[].done_reasonstringReason for task completion. Example: "run_aborted"
Use this endpoint to debug which specific tasks failed or were incomplete in a run.
The done_reason field on individual tasks can differ from the overall run's done_reason.
Compare total_results vs last_result to see if a task collected all expected data.
Code Examples
curl -X GET "https://api.lobstr.io/v1/runtasks?run=300e9c5c127d421c90f431478d9a2cfb&page=1&limit=50" \ -H "Authorization: Token YOUR_API_KEY"
Response
{ "total_results": 1, "limit": 50, "page": 1, "total_pages": 1, "result_from": 1, "result_to": 1, "data": [ { "object": "runtask", "id": "1262f6f99dac7dffb05a513fff0ded77", "started_at": "2025-02-10T14:30:58Z", "ended_at": "2025-02-10T14:31:10Z", "total_results": 138, "last_result": 6, "total_pages": 1, "done_reason": "run_aborted", "last_page": 0, "status": "aborted", "run": "300e9c5c127d421c90f431478d9a2cfb", "task": "d30334cd8d21ab16048c5e2e7136a9f1", "params": { "url": "https://www.google.com/maps/search/restaurant/@43.2928346,5.3662584,17z" }, "last_collection_at": "2025-02-10T14:31:10Z", "done_reason_desc": null } ], "next": null, "previous": null }