Skip to main content
GET
/
v1
/
tasks
List Tasks
curl --request GET \
  --url https://api.lobstr.io/v1/tasks \
  --header 'Authorization: <authorization>'
{
  "total_results": 123,
  "limit": 123,
  "page": 123,
  "total_pages": 123,
  "data": [
    {}
  ],
  "data[].id": "<string>",
  "data[].created_at": "<string>",
  "data[].is_active": true,
  "data[].params": {},
  "next": {},
  "previous": {}
}
This endpoint retrieves a paginated list of tasks for a specific squid. You can choose between two query types to get different levels of detail.

​
Headers

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

​
Query Parameters

ParameterTypeRequiredDescription
squidstringYesThe squid hash ID to list tasks for
typestringNoResponse detail level: ‘url’ (basic) or ‘params’ (detailed). Default: ‘url’
pageintegerNoPage number for pagination. Default: 1
limitintegerNoResults per page. Default: 50, Max: 100

​
Response Field Explanations

​
total_results
integer
Total number of tasks. Example: 2
​
limit
integer
Maximum results per page. Example: 50
​
page
integer
Current page number. Example: 1
​
total_pages
integer
Total number of pages. Example: 1
​
data
array
Array of task objects. Example: [...]
​
data[].id
string
Unique task identifier. Example: "6b9d3afdf4e76df374915a50d7a495c4"
​
data[].created_at
string
Task creation timestamp. Example: "2025-03-05T09:24:49.581177"
​
data[].is_active
boolean
Whether the task is active. Example: true
​
data[].params
object
Task parameters. Example: {"url": "..."}
​
next
string | null
URL for next page (null if last page). Example: null
​
previous
string | null
URL for previous page (null if first page). Example: null
Use type=url for a quick overview of tasks, or type=params when you need full parameter details.
Results are paginated. Use the next and previous URLs to navigate through large task lists.
Check is_active to identify tasks that are ready to run vs. disabled tasks.

​
Code Examples

curl -X GET "https://api.lobstr.io/v1/tasks?squid=a1b2c3d4e5f6g7h8i9j0&type=params&page=1&limit=50" \
  -H "Authorization: Token YOUR_API_KEY"

​
Response

200
{
  "total_results": 2,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "data": [
    {
      "id": "6b9d3afdf4e76df374915a50d7a495c4",
      "created_at": "2025-03-05T09:24:49.581177",
      "is_active": true,
      "params": {
        "url": "https://www.linkedin.com/in/johndoe"
      }
    },
    {
      "id": "c5e29d2aba8b77cdc56391e7405302de",
      "created_at": "2025-03-05T09:24:49.581177",
      "is_active": true,
      "params": {
        "url": "https://www.linkedin.com/in/janedoe"
      }
    }
  ],
  "next": null,
  "previous": null
}