---
title: "Retrieve repository health statistics"
method: GET
path: "/api/v4/projects/{id}/repository/health"
tags: ["repositories"]
---

# Retrieve repository health statistics

`GET /api/v4/projects/{id}/repository/health`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/repository/health`
- Auth: none declared

Retrieves statistics related to the health of a project repository. This endpoint is rate-limited to 5 requests/hour per project when `generate` is `true`. Available only to users with push access to the repository.

## Path parameters

- `id` string, required

## Query parameters

- `generate` boolean

## Response `200`

Retrieve repository health statistics

- APIEntitiesRepositoryHealth: API_Entities_RepositoryHealth model
  - `size` integer, required
  - `references` APIEntitiesRepositoryHealthReferences, required
    - `loose_count` integer, required
    - `packed_size` integer, required
    - `reference_backend` string, required
  - `objects` APIEntitiesRepositoryHealthObjects, required
    - `size` integer, required
    - `recent_size` integer, required
    - `stale_size` integer, required
    - `keep_size` integer, required
    - `packfile_count` integer, required
    - `reverse_index_count` integer, required
    - `cruft_count` integer, required
    - `keep_count` integer, required
    - `loose_objects_count` integer, required
    - `stale_loose_objects_count` integer, required
    - `loose_objects_garbage_count` integer, required
  - `commit_graph` APIEntitiesRepositoryHealthCommitGraph, required
    - `commit_graph_chain_length` integer, required
    - `has_bloom_filters` boolean, required
    - `has_generation_data` boolean, required
    - `has_generation_data_overflow` boolean, required
  - `bitmap` APIEntitiesRepositoryHealthBitmap, required
    - `has_hash_cache` boolean, required
    - `has_lookup_table` boolean, required
    - `version` integer, required
  - `multi_pack_index` APIEntitiesRepositoryHealthMultiPackIndex, required
    - `packfile_count` integer, required
    - `version` integer, required
  - `multi_pack_index_bitmap` APIEntitiesRepositoryHealthBitmap, required
    - `has_hash_cache` boolean, required
    - `has_lookup_table` boolean, required
    - `version` integer, required
  - `alternates` object, required
  - `is_object_pool` boolean, required
  - `last_full_repack` APIEntitiesRepositoryHealthLastFullRepack, required
    - `seconds` integer, required
    - `nanos` integer, required
  - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)