GET/v1/runs

List Runs

Retrieve a paginated list of all runs for a specific squid

This endpoint retrieves a paginated list of all runs for a specific squid. Use this to view run history and track past executions.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes

Query Parameters

squid
Type:
string
Required:
Yes
Description:
The squid hash ID to list runs for
page
Type:
integer
Required:
No
Description:
Page number for pagination. Default: 1
limit
Type:
integer
Required:
No
Description:
Results per page. Default: 50, Max: 100

Response Field Explanations

total_results
integer
Total number of runs
Example: 4
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 run objects
Example: [...]
data[].id
string
Unique run identifier
Example: 381cfbb47e474782857ddc035298b6f3
data[].status
string
Current run status
Example: done
data[].is_done
boolean
Whether the run has completed
Example: true
data[].total_results
integer
Number of results collected
Example: 156
data[].duration
float
Run duration in seconds
Example: 3.1849
data[].credit_used
float
Credits consumed
Example: 3.1849
data[].done_reason
stringnull
Reason for completion
Example: tasks_done
next
stringnull
URL for next page (null if last page)
Example: null
previous
stringnull
URL for previous page (null if first page)
Example: null
Pro Tip

Pro Tip

Use this endpoint to monitor all past and current runs for a squid.
Note

Note

Runs are returned in reverse chronological order (newest first).
Pro Tip

Pro Tip

Check is_done to quickly filter completed vs. active runs.