---
title: "Get a pull request in the merge queue"
method: GET
path: "/repos/{owner}/{repository}/merge-queue/pull/{pr_number}"
tags: ["merge_queue"]
---

# Get a pull request in the merge queue

`GET /repos/{owner}/{repository}/merge-queue/pull/{pr_number}`

Get details about a specific pull request in the merge queue

## Path parameters

- `pr_number` integer, required — The pull request number
- `owner` string, required — The owner of the repository
- `repository` string, required — The name of the repository

## Response `200`

Successful Response

- MergeQueuePullRequest
  - `number` integer, required — The number of the pull request
  - `queued_at` string, date-time, required — The timestamp when the pull request entered the queue
  - `estimated_time_of_merge` string, date-time, nullable, required — The estimated timestamp when this pull request will be merged
  - `position` integer, required — The position of the pull request in the queue (0-indexed)
  - `priority_rule_name` string, required — The name of the priority rule applied to this pull request
  - `queue_rule_name` string, required — The name of the queue rule
  - `checks_timeout_at` string, date-time, nullable, required — The timestamp when the checks will timeout for this pull request
  - `queue_rule` QueueRule, required
    - `name` string, required — The name of the queue rule
    - `config` object, required — The configuration of the queue rule
  - `mergeability_check` MergeQueueMergeabilityCheck, required
    - `check_type` 'in_place' | 'draft_pr' | 'trusted', required — The type of queue check: `in_place` (checks run on the pull request itself), `draft_pr` (checks run on a Mergify draft pull request), or `trusted` (no fresh queue check ran; the pull request was merged trusting its own green CI because the base commits it was missing did not affect its scopes).
    - `queue_pull_request_number` integer, required — The number of the pull request used by the speculative check
    - `started_at` string, date-time, nullable, required — The timestamp when the checks started for this pull request
    - `ci_ended_at` string, date-time, nullable, required — The timestamp when the CI ended for this pull request
    - `ci_state` 'pending' | 'success' | 'failed', required — The combined state of the CI checks
    - `state` string, required — The overall queue check conclusion
    - `checks` QueueCheck[], required — The list of pull request checks
      - `name` string, required — Check name
      - `description` string, required — Check description
      - `url` string, nullable, required — Check detail url
      - `details_url` string, nullable — External integrator's direct URL (e.g. Jenkins build URL)
      - `state` 'failure' | 'error' | 'cancelled' | 'action_required' | 'timed_out' | 'pending' | 'neutral' | 'skipped' | 'stale' | 'success', required
      - `avatar_url` string, nullable, required — Check avatar_url
    - `conditions_evaluation` QueueConditionEvaluationJsonSerialized, required
      - `match` boolean, required
      - `label` string, required
      - `description` string, nullable, required
      - `documentation_url` string, nullable, required
      - `schedule` ScheduleJSON, required
        - `timezone` string, required
        - `days` object, required
      - `subconditions` QueueConditionEvaluationJsonSerialized[], required
      - `evaluations` Evaluation[], required
        - `pull_request` integer, required
        - `match` boolean, required
        - `evaluation_error` string, nullable, required
        - `related_checks` string[], required
        - `next_evaluation_at` string, date-time, nullable, required

## Other responses

- `403` — Forbidden
- `404` — The pull request is not found in any merge queue.
- `409` — Conflict
- `422` — Unprocessable entity

---

[API](https://skmtc.net/mergify/apis/mergify-api.md) · [All operations](https://skmtc.net/mergify/apis/mergify-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mergify/mergify-api/revisions/ae394a06c465/schema)