Skip to content

Project statistics API

DETAILS: Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Every API call to project statistics must be authenticated. Retrieving these statistics requires read access to the repository.

For use with a personal access token, use a token with read_api scope. For a group access token, you can use Reporter role and read_api scope.

This API retrieves the number of times the project is either cloned or pulled with the HTTP method. SSH fetches are not included.

Get the statistics of the last 30 days

GET /projects/:id/statistics
Attribute Type Required Description
id integer or string yes The ID or URL-encoded path of the project

Example response:

{
  "fetches": {
    "total": 50,
    "days": [
      {
        "count": 10,
        "date": "2018-01-10"
      },
      {
        "count": 10,
        "date": "2018-01-09"
      },
      {
        "count": 10,
        "date": "2018-01-08"
      },
      {
        "count": 10,
        "date": "2018-01-07"
      },
      {
        "count": 10,
        "date": "2018-01-06"
      }
    ]
  }
}