{"meta":{"title":"REST API endpoints for repository statistics","intro":"Use the REST API to fetch the data that GitHub uses for visualizing different types of repository activity.","product":"REST API","breadcrumbs":[{"href":"/en/enterprise-server@3.22/rest","title":"REST API"},{"href":"/en/enterprise-server@3.22/rest/metrics","title":"Metrics"},{"href":"/en/enterprise-server@3.22/rest/metrics/statistics","title":"Statistics"}],"documentType":"article"},"body":"# REST API endpoints for repository statistics\n\nUse the REST API to fetch the data that GitHub uses for visualizing different types of repository activity.\n\n## About repository statistics\n\nYou can use the REST API to fetch the data that GitHub uses for visualizing different types of repository activity.\n\n### Best practices for caching\n\nComputing repository statistics is an expensive operation, so we try to return cached\ndata whenever possible. If the data hasn't been cached when you query a repository's\nstatistics, you'll receive a `202` response; a background job is also fired to\nstart compiling these statistics. You should allow the job a short time to complete, and\nthen submit the request again. If the job has completed, that request will receive a\n`200` response with the statistics in the response body.\n\nRepository statistics are cached by the SHA of the repository's default branch; pushing to the default branch resets the statistics cache.\n\n### Statistics exclude some types of commits\n\nThe statistics exposed by the API match the statistics shown by [different repository graphs](/en/enterprise-server@3.22/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs).\n\nTo summarize this:\n\n* All statistics exclude merge commits.\n* Contributor statistics also exclude empty commits.\n\n> \\[!NOTE]\n> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.\n\n## Get the weekly commit activity\n\n```\nGET /repos/{owner}/{repo}/stats/code_frequency\n```\n\nReturns a weekly aggregate of the number of additions and deletions pushed to a repository.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - Returns a weekly aggregate of the number of additions and deletions pushed to a repository.\n\n* **202** - Accepted\n\n* **204** - A header with no content is returned.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/code_frequency\n```\n\n**Response schema (Status: 200):**\n\nArray of array\n\n## Get the last year of commit activity\n\n```\nGET /repos/{owner}/{repo}/stats/commit_activity\n```\n\nReturns the last year of commit activity grouped by week. The days array is a group of commits per day, starting on Sunday.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - OK\n\n* **202** - Accepted\n\n* **204** - A header with no content is returned.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/commit_activity\n```\n\n**Response schema (Status: 200):**\n\nArray of `Commit Activity`:\n\n* `days`: required, array of integer\n* `total`: required, integer\n* `week`: required, integer\n\n## Get all contributor commit activity\n\n```\nGET /repos/{owner}/{repo}/stats/contributors\n```\n\nReturns the total number of commits authored by the contributor. In addition, the response includes a Weekly Hash (weeks array) with the following information:\n\nw - Start of the week, given as a Unix timestamp.\na - Number of additions\nd - Number of deletions\nc - Number of commits\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - OK\n\n* **202** - Accepted\n\n* **204** - A header with no content is returned.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/contributors\n```\n\n**Response schema (Status: 200):**\n\nArray of `Contributor Activity`:\n\n* `author`: required, any of:\n  * **null**\n  * **Simple User**\n    * `name`: string or null\n    * `email`: string or null\n    * `login`: required, string\n    * `id`: required, integer, format: int64\n    * `node_id`: required, string\n    * `avatar_url`: required, string, format: uri\n    * `gravatar_id`: required, string or null\n    * `url`: required, string, format: uri\n    * `html_url`: required, string, format: uri\n    * `followers_url`: required, string, format: uri\n    * `following_url`: required, string\n    * `gists_url`: required, string\n    * `starred_url`: required, string\n    * `subscriptions_url`: required, string, format: uri\n    * `organizations_url`: required, string, format: uri\n    * `repos_url`: required, string, format: uri\n    * `events_url`: required, string\n    * `received_events_url`: required, string, format: uri\n    * `type`: required, string\n    * `site_admin`: required, boolean\n    * `starred_at`: string\n    * `user_view_type`: string\n* `total`: required, integer\n* `weeks`: required, array of objects:\n  * `w`: integer\n  * `a`: integer\n  * `d`: integer\n  * `c`: integer\n\n## Get the weekly commit count\n\n```\nGET /repos/{owner}/{repo}/stats/participation\n```\n\nReturns the total commit counts for the owner and total commit counts in all. all is everyone combined, including the owner in the last 52 weeks. If you'd like to get the commit counts for non-owners, you can subtract owner from all.\nThe array order is oldest week (index 0) to most recent week.\nThe most recent week is seven days ago at UTC midnight to today at UTC midnight.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - The array order is oldest week (index 0) to most recent week.\n\n* **404** - Resource not found\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/participation\n```\n\n**Response schema (Status: 200):**\n\n* `all`: required, array of integer\n* `owner`: required, array of integer\n\n## Get the hourly commit count for each day\n\n```\nGET /repos/{owner}/{repo}/stats/punch_card\n```\n\nEach array contains the day number, hour number, and number of commits:\n\n0-6: Sunday - Saturday\n0-23: Hour of day\nNumber of commits\n\nFor example, \\[2, 14, 25] indicates that there were 25 total commits, during the 2:00pm hour on Tuesdays. All times are based on the time zone of individual commits.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - For example, \\[2, 14, 25] indicates that there were 25 total commits, during the 2:00pm hour on Tuesdays. All times are based on the time zone of individual commits.\n\n* **204** - A header with no content is returned.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/stats/punch_card\n```\n\n**Response schema (Status: 200):**\n\nSame response schema as [Get the weekly commit activity](#get-the-weekly-commit-activity)."}