List completed merge queue testing for a time range

curl --request POST \
  --url https://api.trunk.io/v1/listMergeQueueTestingResults \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '
{
  "repo": {
    "host": "github.com",
    "owner": "trunk-io",
    "name": "trunk"
  },
  "targetBranch": "main",
  "since": "2024-01-01T00:00:00Z",
  "until": "2024-01-08T00:00:00Z",
  "offset": 0,
  "take": 50
}
'

import requests

url = "https://api.trunk.io/v1/listMergeQueueTestingResults"

payload = {
    "repo": {
        "host": "github.com",
        "owner": "trunk-io",
        "name": "trunk"
    },
    "targetBranch": "main",
    "since": "2024-01-01T00:00:00Z",
    "until": "2024-01-08T00:00:00Z",
    "offset": 0,
    "take": 50
}
headers = {
    "x-api-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    repo: {host: 'github.com', owner: 'trunk-io', name: 'trunk'},
    targetBranch: 'main',
    since: '2024-01-01T00:00:00Z',
    until: '2024-01-08T00:00:00Z',
    offset: 0,
    take: 50
  })
};

fetch('https://api.trunk.io/v1/listMergeQueueTestingResults', 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/v1/listMergeQueueTestingResults",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'repo' => [
        'host' => 'github.com',
        'owner' => 'trunk-io',
        'name' => 'trunk'
    ],
    'targetBranch' => 'main',
    'since' => '2024-01-01T00:00:00Z',
    'until' => '2024-01-08T00:00:00Z',
    'offset' => 0,
    'take' => 50
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-token: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.trunk.io/v1/listMergeQueueTestingResults"

	payload := strings.NewReader("{\n  \"repo\": {\n    \"host\": \"github.com\",\n    \"owner\": \"trunk-io\",\n    \"name\": \"trunk\"\n  },\n  \"targetBranch\": \"main\",\n  \"since\": \"2024-01-01T00:00:00Z\",\n  \"until\": \"2024-01-08T00:00:00Z\",\n  \"offset\": 0,\n  \"take\": 50\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.trunk.io/v1/listMergeQueueTestingResults")
  .header("x-api-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"repo\": {\n    \"host\": \"github.com\",\n    \"owner\": \"trunk-io\",\n    \"name\": \"trunk\"\n  },\n  \"targetBranch\": \"main\",\n  \"since\": \"2024-01-01T00:00:00Z\",\n  \"until\": \"2024-01-08T00:00:00Z\",\n  \"offset\": 0,\n  \"take\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v1/listMergeQueueTestingResults")

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

request = Net::HTTP::Post.new(url)
request["x-api-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"repo\": {\n    \"host\": \"github.com\",\n    \"owner\": \"trunk-io\",\n    \"name\": \"trunk\"\n  },\n  \"targetBranch\": \"main\",\n  \"since\": \"2024-01-01T00:00:00Z\",\n  \"until\": \"2024-01-08T00:00:00Z\",\n  \"offset\": 0,\n  \"take\": 50\n}"

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

{
  "testingResults": [
    {
      "prNumber": 123,
      "testingDurationMs": 123,
      "endedAt": "<string>",
      "outcome": "passed",
      "cycleConclusion": "merged",
      "bisection": "in_bisection",
      "testRunId": "<string>"
    }
  ],
  "totalItems": 123
}

"<string>"

"<string>"

"<string>"

"<string>"

Pull Request Endpoints

List completed merge queue testing for a time range

Returns the stretches of testing a merge queue completed in the given range, newest first. One entry per pull request per attempt: a pull request appears several times if its testing restarted, and a batched test run appears once per pull request it tested. Testing still in progress is not included. Pass an entry’s testRunId to /getMergeQueueTestingDetails for the run’s check suites, statuses and tested pull requests.

POST

listMergeQueueTestingResults

curl --request POST \
  --url https://api.trunk.io/v1/listMergeQueueTestingResults \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '
{
  "repo": {
    "host": "github.com",
    "owner": "trunk-io",
    "name": "trunk"
  },
  "targetBranch": "main",
  "since": "2024-01-01T00:00:00Z",
  "until": "2024-01-08T00:00:00Z",
  "offset": 0,
  "take": 50
}
'

import requests

url = "https://api.trunk.io/v1/listMergeQueueTestingResults"

payload = {
    "repo": {
        "host": "github.com",
        "owner": "trunk-io",
        "name": "trunk"
    },
    "targetBranch": "main",
    "since": "2024-01-01T00:00:00Z",
    "until": "2024-01-08T00:00:00Z",
    "offset": 0,
    "take": 50
}
headers = {
    "x-api-token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-token': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    repo: {host: 'github.com', owner: 'trunk-io', name: 'trunk'},
    targetBranch: 'main',
    since: '2024-01-01T00:00:00Z',
    until: '2024-01-08T00:00:00Z',
    offset: 0,
    take: 50
  })
};

fetch('https://api.trunk.io/v1/listMergeQueueTestingResults', 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/v1/listMergeQueueTestingResults",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'repo' => [
        'host' => 'github.com',
        'owner' => 'trunk-io',
        'name' => 'trunk'
    ],
    'targetBranch' => 'main',
    'since' => '2024-01-01T00:00:00Z',
    'until' => '2024-01-08T00:00:00Z',
    'offset' => 0,
    'take' => 50
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-token: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.trunk.io/v1/listMergeQueueTestingResults"

	payload := strings.NewReader("{\n  \"repo\": {\n    \"host\": \"github.com\",\n    \"owner\": \"trunk-io\",\n    \"name\": \"trunk\"\n  },\n  \"targetBranch\": \"main\",\n  \"since\": \"2024-01-01T00:00:00Z\",\n  \"until\": \"2024-01-08T00:00:00Z\",\n  \"offset\": 0,\n  \"take\": 50\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.trunk.io/v1/listMergeQueueTestingResults")
  .header("x-api-token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"repo\": {\n    \"host\": \"github.com\",\n    \"owner\": \"trunk-io\",\n    \"name\": \"trunk\"\n  },\n  \"targetBranch\": \"main\",\n  \"since\": \"2024-01-01T00:00:00Z\",\n  \"until\": \"2024-01-08T00:00:00Z\",\n  \"offset\": 0,\n  \"take\": 50\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.trunk.io/v1/listMergeQueueTestingResults")

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

request = Net::HTTP::Post.new(url)
request["x-api-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"repo\": {\n    \"host\": \"github.com\",\n    \"owner\": \"trunk-io\",\n    \"name\": \"trunk\"\n  },\n  \"targetBranch\": \"main\",\n  \"since\": \"2024-01-01T00:00:00Z\",\n  \"until\": \"2024-01-08T00:00:00Z\",\n  \"offset\": 0,\n  \"take\": 50\n}"

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

{
  "testingResults": [
    {
      "prNumber": 123,
      "testingDurationMs": 123,
      "endedAt": "<string>",
      "outcome": "passed",
      "cycleConclusion": "merged",
      "bisection": "in_bisection",
      "testRunId": "<string>"
    }
  ],
  "totalItems": 123
}

"<string>"

"<string>"

"<string>"

"<string>"

Authorizations

x-api-token

string

header

required

Body

application/json

repo

object

required

The repository whose merge queue ran the testing.

Show child attributes

targetBranch

string

required

The target branch of the merge queue.

Example:

"main"

since

string<date-time>

required

ISO 8601 timestamp (inclusive). Only testing that finished at or after this time is returned. Must be no more than 45 days before until; merge metrics are retained for 45 days, so anything earlier returns nothing.

Example:

"2024-01-01T00:00:00Z"

until

string<date-time>

ISO 8601 timestamp (inclusive) bounding the upper end of the range. Defaults to now.

Example:

"2024-01-08T00:00:00Z"

offset

integer

default:0

Number of results to skip. Defaults to 0.

Required range: x >= 0

take

integer

default:50

Number of results to return (1-100). Defaults to 50.

Required range: 1 <= x <= 100

Response

testingResults

object[]

required

Completed stretches of merge queue testing, newest first. One entry per pull request per attempt, so a pull request appears several times if its testing restarted, and a batched test run appears once per pull request it tested. Testing still in progress is not included.

Show child attributes

totalItems

number

required

The total number of results matching the request, ignoring offset and take.