Skip to main content
GET
List test runs

Authorizations

Authorization
string
header
required

API key authentication using Bearer token format. The CLI's ta auth access tokens are also accepted; because they name a user rather than a workspace, a user in several workspaces selects one with the x-testerarmy-team header (workspace id or slug).

Query Parameters

limit
string

Max results per page (default 20, max 100)

Pattern: ^(?:[1-9]|[1-9][0-9]|100)$
status
enum<string>

Filter by status

Available options:
queued,
running,
completed,
failed,
cancelled
projectId
string<uuid>

Filter by project ID

testId
string<uuid>

Filter by test ID

batchId
string<uuid>

Filter by group-run batch ID

cursor
string

Cursor for pagination

Response

List of runs

runs
object[]
required

List of runs

nextCursor
string | null

Cursor for fetching the next page