List a pull request's verification runs

curl --request GET \
  --url https://api.trunk.io/v2/pull-requests/{id}/verification-runs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.trunk.io/v2/pull-requests/{id}/verification-runs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.trunk.io/v2/pull-requests/{id}/verification-runs', 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/pull-requests/{id}/verification-runs",
  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/pull-requests/{id}/verification-runs"

	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/pull-requests/{id}/verification-runs")

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": "a1b2c3d4-e5f6-4718-9a0b-1c2d3e4f5061",
      "isBisection": false,
      "testBranch": "trunk-merge/01HX3K",
      "testBranchSha": "1f0a9b8c7d6e5f40312233445566778899aabbcc",
      "createdAt": "2026-07-28T11:05:00.000Z",
      "updatedAt": "2026-07-28T11:35:00.000Z",
      "status": "succeeded",
      "requiredStatuses": [
        "Lint (typescript)",
        "Test (rust)"
      ],
      "checks": [
        {
          "id": "31245987",
          "name": "build",
          "kind": "checkRun",
          "status": "completed",
          "conclusion": "success",
          "url": "https://github.com/acme/widgets/runs/31245987",
          "provider": "github",
          "providerStatus": "COMPLETED",
          "providerConclusion": "SUCCESS"
        }
      ],
      "testedPullRequests": [
        {
          "id": "6f1d2c3b-4a59-4e6f-8a7b-9c0d1e2f3a4b",
          "number": 4901,
          "sha": "9c58bf40e5c1a2b3d4e5f60718293a4b5c6d7e8f",
          "title": "Add the widget endpoint",
          "url": "https://github.com/acme/widgets/pull/4901"
        }
      ],
      "dependentPullRequests": [
        {
          "id": "6f1d2c3b-4a59-4e6f-8a7b-9c0d1e2f3a4b",
          "number": 4901,
          "sha": "0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d",
          "title": "Add the widget endpoint",
          "url": "https://github.com/acme/widgets/pull/4901"
        }
      ],
      "testBranchCommitUrl": "https://github.com/acme/widgets/commit/1f0a9b8c7d6e5f40312233445566778899aabbcc",
      "requiredStatusesSource": "trunkConfig",
      "testBranchPullRequest": {
        "number": 5002,
        "url": "https://github.com/acme/widgets/pull/5002"
      },
      "impactedTargets": {
        "all": {
          "impactsAllTargets": false,
          "impactedTargets": [
            "//lib/db",
            "//svc/api"
          ],
          "totalImpactedTargets": 2
        },
        "testedPullRequestsOnly": {
          "impactsAllTargets": false,
          "impactedTargets": [
            "//lib/db",
            "//svc/api"
          ],
          "totalImpactedTargets": 2
        }
      }
    }
  ],
  "nextCursor": "AQEKZm9vYmFy",
  "hasMore": true,
  "total": 1247
}

Testing

List a pull request's verification runs

Lists every verification run that tested this pull request, newest first — including a run it shared with others, which is reported here for each pull request in the batch. sort and direction are not configurable yet: each accepts only the value this list already uses (createdAt, desc) and rejects anything else with 400. createdAfter is not served on this endpoint at all and is rejected with 400 whatever the value; the queue’s own verification-run list does serve it.

GET

pull-requests

{id}

verification-runs

List a pull request's verification runs

curl --request GET \
  --url https://api.trunk.io/v2/pull-requests/{id}/verification-runs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.trunk.io/v2/pull-requests/{id}/verification-runs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.trunk.io/v2/pull-requests/{id}/verification-runs', 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/pull-requests/{id}/verification-runs",
  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/pull-requests/{id}/verification-runs"

	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/pull-requests/{id}/verification-runs")

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": "a1b2c3d4-e5f6-4718-9a0b-1c2d3e4f5061",
      "isBisection": false,
      "testBranch": "trunk-merge/01HX3K",
      "testBranchSha": "1f0a9b8c7d6e5f40312233445566778899aabbcc",
      "createdAt": "2026-07-28T11:05:00.000Z",
      "updatedAt": "2026-07-28T11:35:00.000Z",
      "status": "succeeded",
      "requiredStatuses": [
        "Lint (typescript)",
        "Test (rust)"
      ],
      "checks": [
        {
          "id": "31245987",
          "name": "build",
          "kind": "checkRun",
          "status": "completed",
          "conclusion": "success",
          "url": "https://github.com/acme/widgets/runs/31245987",
          "provider": "github",
          "providerStatus": "COMPLETED",
          "providerConclusion": "SUCCESS"
        }
      ],
      "testedPullRequests": [
        {
          "id": "6f1d2c3b-4a59-4e6f-8a7b-9c0d1e2f3a4b",
          "number": 4901,
          "sha": "9c58bf40e5c1a2b3d4e5f60718293a4b5c6d7e8f",
          "title": "Add the widget endpoint",
          "url": "https://github.com/acme/widgets/pull/4901"
        }
      ],
      "dependentPullRequests": [
        {
          "id": "6f1d2c3b-4a59-4e6f-8a7b-9c0d1e2f3a4b",
          "number": 4901,
          "sha": "0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d",
          "title": "Add the widget endpoint",
          "url": "https://github.com/acme/widgets/pull/4901"
        }
      ],
      "testBranchCommitUrl": "https://github.com/acme/widgets/commit/1f0a9b8c7d6e5f40312233445566778899aabbcc",
      "requiredStatusesSource": "trunkConfig",
      "testBranchPullRequest": {
        "number": 5002,
        "url": "https://github.com/acme/widgets/pull/5002"
      },
      "impactedTargets": {
        "all": {
          "impactsAllTargets": false,
          "impactedTargets": [
            "//lib/db",
            "//svc/api"
          ],
          "totalImpactedTargets": 2
        },
        "testedPullRequestsOnly": {
          "impactsAllTargets": false,
          "impactedTargets": [
            "//lib/db",
            "//svc/api"
          ],
          "totalImpactedTargets": 2
        }
      }
    }
  ],
  "nextCursor": "AQEKZm9vYmFy",
  "hasMore": true,
  "total": 1247
}

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 merge-queue permissions it holds; a key with none can read merge queues but change nothing. Those permissions scope merge queue only: every key can use the Flaky Tests and Dynamic CI endpoints, including their writes, whatever permissions it holds.

Path Parameters

string<uuid>

required

The pull request's id.

Example:

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

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

status

enum<string>

One verification-run status. Sending any other value — including a comma-separated list, which is not supported yet — is a 400.

Available options:

inProgress,

failed,

cancelled,

succeeded

Example:

"succeeded"

Response

A page of verification runs

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