Skip to main content
GET
/
v1
/
runtasks
Get Run Tasks
curl --request GET \
  --url https://api.lobstr.io/v1/runtasks \
  --header 'Authorization: <authorization>'
{
  "total_results": 123,
  "data": [
    {}
  ],
  "data[].id": "<string>",
  "data[].object": "<string>",
  "data[].task": "<string>",
  "data[].run": "<string>",
  "data[].status": "<string>",
  "data[].params": {},
  "data[].started_at": "<string>",
  "data[].ended_at": "<string>",
  "data[].total_results": 123,
  "data[].last_result": 123,
  "data[].total_pages": 123,
  "data[].done_reason": "<string>"
}
This endpoint retrieves a paginated list of all tasks executed within a specific run, including their individual status, results, and parameters.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

ParameterTypeRequiredDescription
runstringYesThe run hash ID to get tasks for
pageintegerNoPage number for pagination. Default: 1
limitintegerNoResults per page. Default: 50, Max: 100

​
Response Field Explanations

​
total_results
integer
Total number of run tasks. Example: 1
​
data
array
Array of run task objects. Example: [...]
​
data[].id
string
Unique run task identifier. Example: "1262f6f99dac7dffb05a513fff0ded77"
​
data[].object
string
Always “runtask”. Example: "runtask"
​
data[].task
string
Original task identifier. Example: "d30334cd8d21ab16048c5e2e7136a9f1"
​
data[].run
string
Parent run identifier. Example: "300e9c5c127d421c90f431478d9a2cfb"
​
data[].status
string
Task execution status (completed, aborted, error, etc.). Example: "aborted"
​
data[].params
object
Task parameters. Example: {"url": "https://..."}
​
data[].started_at
string
When task execution started. Example: "2025-02-10T14:30:58Z"
​
data[].ended_at
string
When task execution ended. Example: "2025-02-10T14:31:10Z"
​
data[].total_results
integer
Total results expected from this task. Example: 138
​
data[].last_result
integer
Number of results actually collected. Example: 6
​
data[].total_pages
integer
Total pages processed. Example: 1
​
data[].done_reason
string
Reason 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

200
{
  "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
}