---
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. By default this endpoint will return usage that does not have a cost center.

**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/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)