Files
gitlab-foss/doc/api/statistics.md
2025-04-14 15:13:41 +00:00

61 lines
1.6 KiB
Markdown

---
stage: Software Supply Chain Security
group: Authentication
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments
title: Application statistics API
---
{{< details >}}
- Tier: Free, Premium, Ultimate
- Offering: GitLab Self-Managed, GitLab Dedicated
{{< /details >}}
Use this API to retrieve statistics from your GitLab instance.
Prerequisites:
- You must have administrator access to the instance.
## Get details on current application statistics
Gets details on the current application statistics.
{{< alert type="note" >}}
For values less than 10,000, this endpoint returns an exact count. For values of 10,000 and greater, this endpoint only returns approximate data when
[TablesampleCountStrategy](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/database/count/tablesample_count_strategy.rb?ref_type=heads#L16)
and [ReltuplesCountStrategy](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/database/count/reltuples_count_strategy.rb?ref_type=heads)
strategies are used for calculations.
{{< /alert >}}
```plaintext
GET /application/statistics
```
```shell
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/application/statistics"
```
Example response:
```json
{
"forks": 10,
"issues": 76,
"merge_requests": 27,
"notes": 954,
"snippets": 50,
"ssh_keys": 10,
"milestones": 40,
"users": 50,
"groups": 10,
"projects": 20,
"active_users": 50
}
```