Resolve a repository by its provider URL

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

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

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

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

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": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "provider": "github",
      "path": "acme/widgets",
      "host": "github.com",
      "url": "https://github.com/acme/widgets",
      "defaultBranch": "main",
      "isPrivate": true,
      "createdAt": "2026-01-14T09:12:00.000Z",
      "updatedAt": "2026-07-20T16:44:10.000Z"
    }
  ],
  "nextCursor": "AQEKZm9vYmFy",
  "hasMore": true,
  "total": 1247
}

Repositories

Resolve a repository by its provider URL

Looks up the repositories a provider URL names, scoped to your organization. A .git suffix and trailing slashes are normalized away, so every spelling of the same repository resolves alike and shares a cursor.

An unparseable providerUrl and a genuine empty result both answer PROVIDER_URL_NOT_FOUND, deliberately: a caller must not be able to distinguish a malformed URL from a repository that exists outside their organization. There is no endpoint that enumerates an organization’s repositories, so this is the way to resolve one you can name. If you are heading for a merge queue, GET /v2/merge-queues needs no arguments and returns every queue in your organization already carrying repositoryId, repositoryUrl and targetBranch — one call rather than two.

GET

repositories

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

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

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

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

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": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "provider": "github",
      "path": "acme/widgets",
      "host": "github.com",
      "url": "https://github.com/acme/widgets",
      "defaultBranch": "main",
      "isPrivate": true,
      "createdAt": "2026-01-14T09:12:00.000Z",
      "updatedAt": "2026-07-20T16:44:10.000Z"
    }
  ],
  "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

providerUrl

string

required

The repository's URL on its provider. A .git suffix and trailing slashes are normalized away.

Minimum string length: 1

Example:

"https://github.com/acme/widgets"

Response

A page of repositories

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