---
title: "Get details about testing that Merge Queue is performing"
method: POST
path: "/getMergeQueueTestingDetails"
---

# Get details about testing that Merge Queue is performing

`POST /getMergeQueueTestingDetails`

## Request body

- object
  - `repo` object, required — The repository whose merge queue is running the test run.
    - `host` string, required — The host of the repository (e.g. `github.com`).
    - `owner` string, required — The owner of the repository (e.g. `my-org`).
    - `name` string, required — The name of the repository (e.g. `my-repo`).
  - `testRunId` string, required
  - `targetBranch` string, required — The target branch of the merge queue that is running the test run (e.g. `main`).

## Response `200`

OK

- object
  - `requiredStatuses` string[], required — The list of status check names that must all pass for the test run to succeed and its PRs to merge.
  - `requiredStatusesSource` 'trunk_config' | 'repo_provider_branch_protection' | 'merge_instance' — Where the merge queue sourced the list of required statuses from. `trunk_config` — from the repository's `.trunk/trunk.yaml`. `repo_provider_branch_protection` — from the Git provider's branch protection settings (e.g. GitHub branch protection rules). `merge_instance` — from the merge queue's own configuration (e.g. set via the API).
  - `testBranch` string, required — The name of the temporary branch the merge queue created to run tests against (e.g. `trunk-merge/pr-1815/5df78918-...`).
  - `testBranchSha` string, required — The commit SHA at the tip of the test branch that the test run was started on.
  - `createdAt` string — ISO 8601 timestamp of when the test run was created.
  - `status` 'in_progress' | 'failed' | 'cancelled' | 'succeeded' — The status of a merge queue test run. `in_progress` — tests are currently running. `succeeded` — all required statuses passed. `failed` — at least one required status failed. `cancelled` — the test run was cancelled before completion.
  - `checkSuites` object[], required — GitHub check suites reported against the test branch.
    - `checkRuns` object[], required — The individual check runs that make up this check suite.
      - `name` string, required — The name of the GitHub check run (e.g. `build`, `lint`).
      - `url` string, required — URL to the check run on GitHub.
      - `status` 'QUEUED' | 'IN_PROGRESS' | 'COMPLETED' — The status of a GitHub check run. Mirrors GitHub's check run status values.
      - `conclusion` 'ACTION_REQUIRED' | 'CANCELLED' | 'FAILURE' | 'NEUTRAL' | 'SUCCESS' | 'SKIPPED' | 'STALE' | 'TIMED_OUT' — The conclusion of a completed GitHub check run. Mirrors GitHub's check run conclusion values; only set once `status` is `COMPLETED`.
  - `statusChecks` object[], required — GitHub commit status checks reported against the test branch SHA.
    - `context` string, required — The context (name) of the status check as posted to GitHub (e.g. `ci/lint`).
    - `url` string — URL with more details about this status check, if any.
    - `state` 'ERROR' | 'FAILURE' | 'PENDING' | 'SUCCESS' — The state of a GitHub commit status check. Mirrors GitHub's commit status state values.
  - `testedPullRequests` object[], required — The pull requests that this test run is testing. Contains multiple entries when batching is enabled.
    - `prNumber` number, required — The pull request number on the Git provider.
    - `prUrl` string, required — URL of the pull request on the Git provider.
    - `title` string, required — The title of the pull request.
  - `impactedTargets` string[] — The union of impacted build/test targets across all PRs involved in the test run, including any dependent PRs previously merged into the test branch. Only present when impacted targets are being uploaded for the repository.
  - `impactedTargetsForTestedPrs` string[] — The impacted build/test targets for only the PRs being tested in this run (i.e. `testedPullRequests`), excluding any dependent PRs. Only present when impacted targets are being uploaded for the repository.
  - `dependentPrs` number[] — PR numbers of other PRs this test run depends on but is not itself testing. Populated in parallel-mode queues when previously-passed PRs ahead of the tested PR are merged into the test branch to form the predicted base.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/trunk/apis/trunk-apis.md) · [All operations](https://skmtc.net/trunk/apis/trunk-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trunk/trunk-apis/versions/f7b911d8e24c/schema)