---
title: "Get the queue checks retries statistics"
method: GET
path: "/repos/{owner}/{repository}/stats/checks_retries"
tags: ["statistics"]
---

# Get the queue checks retries statistics

`GET /repos/{owner}/{repository}/stats/checks_retries`

## Request

- Base URL: `https://api.mergify.com/v1`
- URL: `https://api.mergify.com/v1/repos/{owner}/{repository}/stats/checks_retries`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Statistics about checks retries in the merge queue by intervals of time

## 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

- ChecksRetriesResponse
  - `groups` ChecksRetriesGroupResponse[], required
    - `base_ref` string, required
    - `queue_name` string, required
    - `priority_rule_name` string, nullable, required
    - `stats` ChecksRetriesInInterval[], required
      - `start` string, date-time, required
      - `end` string, date-time, required
      - `total_retries` integer, required
      - `sessions_with_retries` integer, required
      - `recovered` integer, required
      - `not_recovered` integer, required
      - `recovery_rate` number, required
      - `avg_retry_depth` number, required
      - `max_retry_depth` integer, required

## Other responses

- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable entity

## Changes

- **2026-08-28** `b3864dcc206a`: 1 info
  - the endpoint scheme security `MergifyTokenBearerAuth` was added to the API
- **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/checks_retries/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)