---
title: "Get billing usage summary for an enterprise"
method: GET
path: "/enterprises/{enterprise}/settings/billing/usage/summary"
tags: ["billing"]
---

# Get billing usage summary for an enterprise

`GET /enterprises/{enterprise}/settings/billing/usage/summary`

Gets a summary report of usage for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise. By default, this endpoint will return usage across all cost centers in the enterprise.

**Note:** Only data from the past 24 months is accessible via this endpoint.

## Path parameters

- `enterprise` string, required

## Query parameters

- `year` integer
- `month` integer
- `day` integer
- `organization` string
- `repository` string
- `product` string
- `sku` string
- `cost_center_id` string

## Response `200`

Response when getting a billing usage summary

- BillingUsageSummaryReportGhe
  - `timePeriod` object, required
    - `year` integer, required — The year for the usage report.
    - `month` integer — The month for the usage report.
    - `day` integer — The day for the usage report.
  - `enterprise` string, required — The name of the enterprise for the usage report.
  - `organization` string — The name of the organization for the usage report.
  - `repository` string — The name of the repository for the usage report.
  - `product` string — The product for the usage report.
  - `sku` string — The SKU for the usage report.
  - `costCenter` object
    - `id` string, required — The unique identifier of the cost center.
    - `name` string, required — The name of the cost center.
  - `usageItems` object[], required
    - `product` string, required — Product name.
    - `sku` string, required — SKU name.
    - `unitType` string, required — Unit type of the usage line item.
    - `pricePerUnit` number, required — Price per unit of the usage line item.
    - `grossQuantity` number, required — Gross quantity of the usage line item.
    - `grossAmount` number, required — Gross amount of the usage line item.
    - `discountQuantity` number, required — Discount quantity of the usage line item.
    - `discountAmount` number, required — Discount amount of the usage line item.
    - `netQuantity` number, required — Net quantity of the usage line item.
    - `netAmount` number, required — Net amount of the usage line item.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Error
- `503` — Service unavailable

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-3.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-3/versions/dc0584ac4e13/schema)