List and search test cases

curl --request GET \
  --url https://api.trunk.io/v2/test-cases \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.trunk.io/v2/test-cases', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trunk.io/v2/test-cases",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trunk.io/v2/test-cases"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/test-cases")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "bfeebcf4-0000-8000-8000-000000000001",
      "testCollectionId": "aB3xY9kQ",
      "repoId": "7a2b3c4d-5e6f-4a1b-8c9d-0e1f2a3b4c5d",
      "name": "suite::test_case_name",
      "parentName": "Foo",
      "className": "FooSuite",
      "file": "src/foo.test.ts",
      "target": "//src:foo_test",
      "variant": "",
      "crossVariantId": "5d4c3b2a-1f0e-4a1b-8c9d-0e1f2a3b4c5d",
      "codeowners": [
        "@team-a"
      ],
      "status": "flaky",
      "quarantineState": "notQuarantined",
      "labels": [
        {
          "id": "2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d",
          "name": "slow-on-prs",
          "color": "#4F46E5",
          "description": "Tests that only get slow on pull-request runs.",
          "createdAt": "2026-05-01T00:00:00.000Z"
        }
      ],
      "metrics": {
        "failureRate": 0.25,
        "prsImpacted": 3,
        "runCount": 40,
        "failureCount": 10,
        "durationP95Ms": 1200,
        "lastRunAt": "2026-06-02T10:00:00.000Z",
        "lastFailureAt": "2026-06-01T10:00:00.000Z"
      }
    }
  ],
  "nextCursor": "AQEKZm9vYmFy",
  "hasMore": true,
  "total": 1247
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

API reference (v2)

List and search test cases

Lists test cases, by default across every test collection in your organization — pass testCollectionId to narrow to one. Each row carries the id to pass to the per-test endpoints.

q searches name, file, class and parent as case-insensitive substrings. Several words are separate requirements, not a phrase — q=flaky slow returns tests matching both, in any position. It also accepts per-field qualifiers mixed freely with those words: q=file:checkout flaky class:PaymentTest. Qualifier keys are case-sensitive, and an unrecognized prefix is treated as literal text rather than guessed at.

Rows omit quarantineOverride, activeMonitors, firstSeenAt and lastFailureAt — fetch a single test case for those.

GET

test-cases

List and search test cases

curl --request GET \
  --url https://api.trunk.io/v2/test-cases \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.trunk.io/v2/test-cases', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trunk.io/v2/test-cases",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trunk.io/v2/test-cases"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v2/test-cases")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "bfeebcf4-0000-8000-8000-000000000001",
      "testCollectionId": "aB3xY9kQ",
      "repoId": "7a2b3c4d-5e6f-4a1b-8c9d-0e1f2a3b4c5d",
      "name": "suite::test_case_name",
      "parentName": "Foo",
      "className": "FooSuite",
      "file": "src/foo.test.ts",
      "target": "//src:foo_test",
      "variant": "",
      "crossVariantId": "5d4c3b2a-1f0e-4a1b-8c9d-0e1f2a3b4c5d",
      "codeowners": [
        "@team-a"
      ],
      "status": "flaky",
      "quarantineState": "notQuarantined",
      "labels": [
        {
          "id": "2b3c4d5e-6f70-4a1b-8c9d-0e1f2a3b4c5d",
          "name": "slow-on-prs",
          "color": "#4F46E5",
          "description": "Tests that only get slow on pull-request runs.",
          "createdAt": "2026-05-01T00:00:00.000Z"
        }
      ],
      "metrics": {
        "failureRate": 0.25,
        "prsImpacted": 3,
        "runCount": 40,
        "failureCount": 10,
        "durationP95Ms": 1200,
        "lastRunAt": "2026-06-02T10:00:00.000Z",
        "lastFailureAt": "2026-06-01T10:00:00.000Z"
      }
    }
  ],
  "nextCursor": "AQEKZm9vYmFy",
  "hasMore": true,
  "total": 1247
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

{
  "error": {
    "code": "MERGE_QUEUE_NOT_FOUND",
    "message": "No merge queue found with ID xK9mP2nQ"
  }
}

Authorizations

Authorization

string

header

required

An org-scoped API key, sent as Authorization: Bearer <key>. Existing v1 tokens work here unchanged. There is no enqueue-only or read/write scope: an org key authorized for merge-queue writes can invoke every merge-queue mutation, including changing merge-protection configuration and pausing, draining or deleting a queue.

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

testCollectionId

string

Narrow to one collection, by its id. Omitted searches every collection in your organization.

Minimum string length: 1

Example:

"aB3xY9kQ"

status

string

Comma-separated statuses to include: healthy, flaky, broken.

Minimum string length: 1

Example:

"flaky,broken"

string

Free-text search, with optional file: / class: / parent: / name: qualifiers.

Minimum string length: 1

Example:

"file:checkout flaky"

file

string

Substring match on the test's file path.

Minimum string length: 1

Example:

"src/payments"

owner

string

Exact match on one of the test's code owners.

Minimum string length: 1

Example:

"@acme/platform"

variant

string

Exact match on the test's variant.

Minimum string length: 1

Example:

"ubuntu-22.04"

include

enum<string>

Set to metrics to embed each test's metrics for period in the same response, instead of fetching them per test.

Available options:

metrics

Example:

"metrics"

label

string

Only tests carrying this label, by name. Matched exactly, including case, since two labels may differ only in case. An unknown name returns an empty page, not an error.

Minimum string length: 1

Example:

"slow-on-prs"

quarantineState

enum<string>

Filter on effective quarantine state, derived from the test's status, its collection's quarantine settings and any per-test override.

Available options:

quarantined,

notQuarantined

Example:

"quarantined"

markedFlaky

boolean

Filter on whether the manual 'flag as flaky' mark is currently set.

Example:

true

newlyFlaky

boolean

Only tests that first became flaky inside period. Requires period.

Example:

true

period

enum<string>

Metrics window for include=metrics, any metric sort, and newlyFlaky. Required by each of them.

Available options:

1d,

7d,

14d,

30d

Example:

"7d"

sort

enum<string>

default:name

Field to sort by. A metric sort requires period, and excludes tests with no comparable value in it — no runs at all for most metrics, and additionally no failure for lastFailureAt.

Available options:

name,

failureRate,

durationP95,

prsImpacted,

lastRunAt,

lastFailureAt

direction

enum<string>

Sort direction. Defaults per sort: ascending for name, descending for every metric sort, which order worst-first.

Available options:

asc,

desc

Response

A page of test cases

data

object[]

required

Maximum array length: 100

Show child attributes

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