Skip to main content
GET
Get task runs

Authorizations

x-api-key
string
header
required

Your Recoup API key. Learn more.

Query Parameters

runId
string

The unique identifier of a specific task run to retrieve. If omitted, returns a list of recent runs for the authenticated account.

limit
integer
default:20

Maximum number of runs to return when listing (ignored when runId is provided). Default 20, max 100.

Required range: 1 <= x <= 100
account_id
string<uuid>

Filter runs by account ID. When provided, returns runs tagged with account:<account_id>. Only applicable when the authenticated account has access to multiple accounts via organization membership.

Response

Task runs retrieved successfully.

status
enum<string>
required

Indicates the request was successful

Available options:
success
runs
object[]
required

List of recent task runs for the authenticated account. Each item is a raw Trigger.dev SDK run object (same shape as TaskRunResponse, but without output and error fields).