Skip to main content
GET
List the CI workflow runs on a commit

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer <key>. An organization admin creates one in the Trunk app under Settings → Developer → API Keys and chooses the permissions it holds. A key with none can read merge queues but change nothing in them. Permissions cover merge queues and test-result uploads, including the quarantine lookups a CI run makes before it uploads; any key can call the other Flaky Tests and Dynamic CI endpoints, including their writes.

Query Parameters

limit
integer
default:25

Page size, between 1 and 100.

Required range: 1 <= x <= 100
Example:

25

cursor
string

Opaque cursor from a previous response's nextCursor. A cursor is bound to the operation and filter it was minted for.

Example:

"AQEKZm9vYmFy"

includeTotal
boolean
default:false

Set true to include total in the response. Costs an extra COUNT query, so it is off by default.

Example:

false

pullRequestId
string<uuid>

Read the CI of this pull request. Mutually exclusive with repositoryId.

Example:

"0f8fad5b-d9cb-469f-a165-70867728950e"

repositoryId
string<uuid>

Read the CI of one commit of this repository, for a commit no pull request names, such as a push to the default branch. Needs commitSha.

Example:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

commitSha
string

The full commit sha. Defaults to the pull request's head when pullRequestId is sent.

Pattern: ^[0-9a-f]{40}(?:[0-9a-f]{24})?$
Example:

"a0de7a77e8d758a346f83ed19209a5a25814bb17"

status
string

Comma-separated statuses: running, completed.

Minimum string length: 1
Example:

"running"

conclusion
string

Comma-separated conclusions: success, failure, timedOut, cancelled, skipped. A match has finished.

Minimum string length: 1
Example:

"failure,timedOut"

updatedAfter
string<date-time>

Only rows that changed strictly after this time: queued, started or finished. Send the time of your last read to fetch only what moved.

Example:

"2026-09-29T12:40:00.000Z"

Response

A page of workflow runs

data
object[]
required
Maximum array length: 100
nextCursor
string | null
required

Opaque cursor for the next page, or null on the last page. Pass it back verbatim as cursor; do not construct or inspect one.

Example:

"AQEKZm9vYmFy"

hasMore
boolean
required

True when another page is available.

Example:

true

total
integer

Total rows matching the filter. Present only when the request set includeTotal=true.

Example:

1247