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

# Get billing usage report for an enterprise

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

Gets a report of usage by cost center for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise, or a custom role holder with fine-grained read access to enterprise billing. By default this endpoint will return usage that does not have a cost center. An installation access token for a GitHub App installed on the enterprise with read access to enterprise billing can get this usage report.

**Note:** This endpoint is only available to enterprises with access to the enhanced billing platform. For more information, see "[About the enhanced billing platform for enterprises](https://docs.github.com/enterprise-cloud@latest/billing/using-the-enhanced-billing-platform-for-enterprises/about-the-enhanced-billing-platform-for-enterprises#how-do-i-know-if-i-can-access-the-enhanced-billing-platform)."

## Path parameters

- `enterprise` string, required

## Query parameters

- `year` integer
- `month` integer
- `day` integer
- `cost_center_id` string

## Response `200`

Response when getting a billing usage report

- BillingUsageReport
  - `usageItems` object[]
    - `date` string, required — Date of the usage line item.
    - `product` string, required — Product name.
    - `sku` string, required — SKU name.
    - `quantity` integer, required — Quantity of the usage line item.
    - `unitType` string, required — Unit type of the usage line item.
    - `pricePerUnit` number, required — Price per unit of the usage line item.
    - `grossAmount` number, required — Gross amount of the usage line item.
    - `discountAmount` number, required — Discount amount of the usage line item.
    - `netAmount` number, required — Net amount of the usage line item.
    - `organizationName` string, required — Name of the organization.
    - `repositoryName` string — Name of the repository.

## Other responses

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

---

[API](https://skmtc.net/github/apis/enterprise-cloud.md) · [All operations](https://skmtc.net/github/apis/enterprise-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/enterprise-cloud/revisions/905703de9c0f/schema)