--- title: "Get the queue checks outcome for the repository" method: GET path: "/repos/{owner}/{repository}/stats/merge_queue_checks_outcome" tags: ["statistics"] deprecated: true --- # Get the queue checks outcome for the repository `GET /repos/{owner}/{repository}/stats/merge_queue_checks_outcome` ## Request - Base URL: `https://api.mergify.com/v1` - URL: `https://api.mergify.com/v1/repos/{owner}/{repository}/stats/merge_queue_checks_outcome` - Auth: one of: - HTTP bearer - HTTP bearer - HTTP bearer > **Deprecated.** Statuses describing the state in which the pull requests have left the queue(s). Counted once per pull request a check carried: a batch of five pull requests yields five outcomes for one CI run. `ci_runs` counts CI runs once each, with how each ended. ## Path parameters - `repository` string, required: The name of the repository - `owner` string, required: The owner of the repository ## Query parameters - `base_ref` string[], nullable: Base reference(s) of the pull requests - `queue_name` string[], nullable: Name of the merge queue(s) for the pull requests - `priority_rule_name` string[], nullable: Name of the priority rule(s) of the pull requests - `start_at` string, date-time, nullable: Get the stats from this date: an ISO 8601 datetime with a UTC offset (e.g. `2024-01-01T00:00:00Z`); a Unix timestamp or a datetime without an offset is refused. Defaults to 1 day before `end_at`. - `end_at` string, date-time, nullable: Get the stats until this date: an ISO 8601 datetime with a UTC offset (e.g. `2024-01-01T00:00:00Z`); a Unix timestamp or a datetime without an offset is refused. Defaults to now. ## Response `200` Successful Response - ChecksOutcomeResponse - `groups` ChecksOutcomeGroupResponse[], required - `base_ref` string, required - `queue_name` string, required - `priority_rule_name` string, nullable, required - `stats` QueueChecksOutcome, required - `BASE_BRANCH_CHANGED` integer: The pull request base branch has changed - `BASE_BRANCH_MISSING` integer: The base branch does not exist anymore - `BATCH_MAX_FAILURE_RESOLUTION_ATTEMPTS` integer: The maximum batch failure resolution attempts has been reached - `BATCH_REBUILT` integer: The batch was torn down to be rebuilt - `BATCH_SCOPES_CHANGED` integer: The batch has been recomposed because a pull request's scopes changed - `BRANCH_UPDATE_FAILED` integer: The pull request can't be updated for security reasons - `CHECKS_FAILED` integer: The checks for the queued pull request have failed - `CHECKS_INTERRUPTED` integer: The checks for the queued pull request were cancelled before producing a result - `CHECKS_TIMEOUT` integer: The checks for the queued pull request have timed out - `DROPPED_BY_BISECTION_ELIMINATION` integer: The pull request was dropped untested when batch bisection isolated the failure to other pull requests - `CONFLICT_WITH_BASE_BRANCH` integer: The pull request conflicts with the base branch - `CONFLICT_WITH_PULL_AHEAD` integer: The pull request conflicts with at least one pull request ahead in queue - `DRAFT_PULL_REQUEST_CHANGED` integer: New commits have been added to the draft pull request that were not made by Mergify - `BATCH_PULL_REQUEST_CLOSED` integer: The batch pull request has been closed - `INCOMPATIBILITY_WITH_BRANCH_PROTECTIONS` integer: The pull request cannot be checked because of an incompatibility with branch protections - `MERGE_QUEUE_RESET` integer: The merge queue has been reset - `PR_AHEAD_DEQUEUED` integer: A pull request ahead in the queue has been dequeued - `BATCH_AHEAD_FAILED` integer: A pull request ahead in the queue failed to get merged - `BATCH_AHEAD_BRANCH_EDITED` integer: The branch of a batch ahead in the queue was edited, so this batch has been recomposed on top of it - `BATCH_AHEAD_REBUILT` integer: A batch ahead in the queue was torn down to be rebuilt - `PR_CHECKS_STOPPED_BECAUSE_MERGE_QUEUE_PAUSE` integer: The checks have been interrupted because the merge queue is paused on this repository - `PR_DEQUEUED` integer: Pull request has been dequeued - `PR_DEQUEUED_FROM_PARTITION` integer: Pull request has been dequeued from a partition - `PR_UNEXPECTEDLY_FAILED_TO_MERGE` integer: Pull request unexpectedly failed to get merged - `PR_WITH_HIGHER_PRIORITY_QUEUED` integer: A pull request with a higher priority has been queued - `PULL_REQUEST_UPDATED` integer: The pull request has been unexpectedly updated - `QUEUE_RULE_MISSING` integer: The queue rules are missing because of a configuration change - `SPECULATIVE_CHECK_NUMBER_REDUCED` integer: The number of speculative checks, in the queue rules, has been reduced - `SUCCESS` integer: Successfully merged the pull request - `PR_MANUALLY_MERGED` integer: The pull request has been manually merged - `DRAFT_PULL_REQUEST_CREATION_FAILED` integer: The draft pull request cannot be created - `DRAFT_PULL_REQUEST_CREATION_BRANCH_NOT_INDEXED` integer: The draft pull request cannot be created because GitHub has not indexed the branch yet - `CONFIGURATION_CHANGED` integer: The configuration has changed - `UNPROCESSABLE_PULL_REQUEST` integer: The pull request could not be processed by Mergify - `PR_MANUALLY_DEQUEUED` integer: The pull request has been manually removed from the queue - `STACK_PREDECESSOR_DEQUEUED` integer: The pull request has been dequeued because its stack predecessor was dequeued - `INTERMEDIATE_RESULTS_SKIPPED` integer: The pull request intermediate results have been skipped during batch promotion - `CHECKS_RETRIED` integer: The checks have failed and are being retried - `SCHEDULED_FREEZE_STATUS_CHANGED` integer: The batch has been split because a scheduled freeze changed the freeze status of its pull requests - `SCHEDULE_BLOCKED_AHEAD_YIELDED` integer: A pull request ahead was waiting for its merge schedule, so it yielded its position to let ready pull requests merge first - `BASE_REF_ALIGNMENT_TIMEOUT` integer: The stacked pull request's base branch could not be retargeted onto the queue base branch and was dequeued - `GITHUB_STACKED_PULL_REQUEST_MERGE_UNSUPPORTED` integer: The pull request is a GitHub-native stacked pull request, which GitHub does not allow merging through the API, and was dequeued - `GITHUB_WORKFLOWS_PERMISSION_MISSING` integer: GitHub refused to write the pull request's workflow changes because Mergify lacks the `workflows` permission, and it was dequeued ## Other responses - `403`: Forbidden - `404`: Not found - `409`: Conflict - `422`: Unprocessable entity ## Changes - **2026-10-08** `54c2240a375e`: 2 info - added the optional property `groups/items/stats/BATCH_AHEAD_REBUILT` to the response with the `200` status - added the optional property `groups/items/stats/BATCH_REBUILT` to the response with the `200` status - **2026-09-15** `3a3fde4a18ec`: 1 info - added the optional property `groups/items/stats/GITHUB_WORKFLOWS_PERMISSION_MISSING` to the response with the `200` status - **2026-08-28** `b3864dcc206a`: 1 info - the endpoint scheme security `MergifyTokenBearerAuth` was added to the API - **2026-08-14** `794faf3b4f0d`: 1 info - added the optional property `groups/items/stats/CHECKS_INTERRUPTED` to the response with the `200` status - **2026-08-13** `29857c6146cf`: 2 info - the endpoint scheme security `AdminApplicationKey` was added to the API - the endpoint scheme security `ApplicationAuth` was removed from the API [Operation history](https://skmtc.dev/mergify/apis/mergify-api/changes/repos/:owner/:repository/stats/merge_queue_checks_outcome/get.md) --- [API](https://skmtc.dev/mergify/apis/mergify-api.md) · [All operations](https://skmtc.dev/mergify/apis/mergify-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mergify/apis/mergify-api/revisions/00b8f4a31190?raw)