Resolve pull requests by repository coordinates

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

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

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

	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")

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": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "repositoryId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "number": 4901,
      "title": "feat: terminate /v2 at the gateway",
      "branch": "phil/implement-remaining-apis",
      "sha": "9c58bf40e5c1a2b3d4e5f60718293a4b5c6d7e8f",
      "baseBranch": "main",
      "author": "octocat",
      "isCurrentlySubmittedToQueue": true,
      "createdAt": "2026-07-28T10:55:00.000Z",
      "url": "https://github.com/acme/widgets/pull/4901",
      "state": "open",
      "queueEntry": {
        "id": "6f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
        "mergeQueueId": "xK9mP2nQ",
        "state": "testing",
        "stateChangedAt": "2026-07-28T11:40:02.000Z",
        "skipsTheLine": false,
        "allowBatching": true,
        "direct": false,
        "readiness": {
          "requiresImpactedTargets": true,
          "doesBaseBranchMatch": true,
          "mergeability": "mergeable",
          "hasImpactedTargets": true,
          "mergeabilityDetails": {
            "provider": "github",
            "reasons": [
              {
                "code": "reviewRequired",
                "message": "needs 1 more approving review",
                "have": 0,
                "need": 1
              }
            ]
          }
        },
        "createdAt": "2026-07-28T11:02:31.000Z",
        "updatedAt": "2026-07-28T11:40:02.000Z",
        "priorityValue": 100,
        "priorityName": "high",
        "usedDefaultPriorityName": "medium",
        "verifiedByVerificationRunId": "a1b2c3d4-e5f6-4718-9a0b-1c2d3e4f5061"
      },
      "htmlUrl": "https://app.trunk.io/acme/pull/4901?repo=1a2b3c4d",
      "viewerIsAuthor": true,
      "ci": {
        "headSha": "a0de7a77e8d758a346f83ed19209a5a25814bb17",
        "observedAt": "2026-09-29T15:12:25.000Z",
        "pollAfterSeconds": 10,
        "jobs": {
          "total": 209,
          "queued": 0,
          "running": 0,
          "passed": 110,
          "failed": 2,
          "cancelled": 0,
          "skipped": 97,
          "abandoned": 0
        },
        "jobsUrl": "/v2/ci-jobs?pullRequestId=0f8fad5b-d9cb-469f-a165-70867728950e&commitSha=a0de7a77e8d758a346f83ed19209a5a25814bb17",
        "workflowRunsUrl": "/v2/ci-workflow-runs?pullRequestId=0f8fad5b-d9cb-469f-a165-70867728950e&commitSha=a0de7a77e8d758a346f83ed19209a5a25814bb17"
      }
    }
  ],
  "nextCursor": "AQEKZm9vYmFy",
  "hasMore": true,
  "total": 1247
}

Pull requests

Resolve pull requests by repository coordinates

Looks pull requests up by their provider coordinates within one repository. Send exactly one of number or branch.

number takes up to 50 comma-separated numbers. (repositoryId, number) is unique, so each matches at most one pull request; numbers Trunk has not indexed are simply absent from the page, so recover them by diffing what you asked for against the numbers you got back.

branch is a head branch, which can carry several pull requests over time, so it resolves to the open one if there is one and otherwise the most recently created. Pair it with baseBranch — a merge queue’s target branch — to scope the answer to pull requests aimed there.

Rows come back ordered by number ascending, which is not necessarily the order you asked in. A batch can exceed limit, so this page really does paginate — follow nextCursor rather than assuming one page. readiness.hasImpactedTargets is resolved only for a lookup that ASKED for a single pull request (branch, or one number); resolving it costs a storage lookup each, so a multi-number lookup omits it whatever it matches, as the queue’s list read does. ci follows the same rule: a lookup that asked for one pull request carries it, and a multi-number lookup does not.

GET

pull-requests

Resolve pull requests by repository coordinates

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

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

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

	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")

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": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "repositoryId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "number": 4901,
      "title": "feat: terminate /v2 at the gateway",
      "branch": "phil/implement-remaining-apis",
      "sha": "9c58bf40e5c1a2b3d4e5f60718293a4b5c6d7e8f",
      "baseBranch": "main",
      "author": "octocat",
      "isCurrentlySubmittedToQueue": true,
      "createdAt": "2026-07-28T10:55:00.000Z",
      "url": "https://github.com/acme/widgets/pull/4901",
      "state": "open",
      "queueEntry": {
        "id": "6f1c2d3e-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
        "mergeQueueId": "xK9mP2nQ",
        "state": "testing",
        "stateChangedAt": "2026-07-28T11:40:02.000Z",
        "skipsTheLine": false,
        "allowBatching": true,
        "direct": false,
        "readiness": {
          "requiresImpactedTargets": true,
          "doesBaseBranchMatch": true,
          "mergeability": "mergeable",
          "hasImpactedTargets": true,
          "mergeabilityDetails": {
            "provider": "github",
            "reasons": [
              {
                "code": "reviewRequired",
                "message": "needs 1 more approving review",
                "have": 0,
                "need": 1
              }
            ]
          }
        },
        "createdAt": "2026-07-28T11:02:31.000Z",
        "updatedAt": "2026-07-28T11:40:02.000Z",
        "priorityValue": 100,
        "priorityName": "high",
        "usedDefaultPriorityName": "medium",
        "verifiedByVerificationRunId": "a1b2c3d4-e5f6-4718-9a0b-1c2d3e4f5061"
      },
      "htmlUrl": "https://app.trunk.io/acme/pull/4901?repo=1a2b3c4d",
      "viewerIsAuthor": true,
      "ci": {
        "headSha": "a0de7a77e8d758a346f83ed19209a5a25814bb17",
        "observedAt": "2026-09-29T15:12:25.000Z",
        "pollAfterSeconds": 10,
        "jobs": {
          "total": 209,
          "queued": 0,
          "running": 0,
          "passed": 110,
          "failed": 2,
          "cancelled": 0,
          "skipped": 97,
          "abandoned": 0
        },
        "jobsUrl": "/v2/ci-jobs?pullRequestId=0f8fad5b-d9cb-469f-a165-70867728950e&commitSha=a0de7a77e8d758a346f83ed19209a5a25814bb17",
        "workflowRunsUrl": "/v2/ci-workflow-runs?pullRequestId=0f8fad5b-d9cb-469f-a165-70867728950e&commitSha=a0de7a77e8d758a346f83ed19209a5a25814bb17"
      }
    }
  ],
  "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.

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

repositoryId

string<uuid>

required

The repository the pull requests belong to.

Example:

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

number

string

One provider pull-request number, or up to 50 comma-separated, each between 1 and 10000000. Mutually exclusive with branch. Deliberately typed as a string rather than published with a pattern: the route's own parse names the offending member, which a schema-level rejection cannot.

Minimum string length: 1

Example:

"4901,4902"

branch

string

A head branch. Resolves to the open pull request from it, else the most recently created. Mutually exclusive with number.

Minimum string length: 1

Example:

"feature/widget-limit"

baseBranch

string

Narrows a branch lookup to pull requests targeting this base — a merge queue's target branch. Sending it without branch is a 400 rather than ignored.

Minimum string length: 1

Example:

"main"

Response

A page of the matching pull requests

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