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

# Get billing premium request usage report for an enterprise

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

Gets a report of premium request usage for an enterprise. To use this endpoint, you must be an administrator or billing manager of 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
- `user` string
- `model` string
- `product` string
- `cost_center_id` string

## Response `200`

Response when getting a billing premium request usage report

- BillingPremiumRequestUsageReportGhe
  - `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.
  - `user` string — The name of the user for the usage report.
  - `organization` string — The name of the organization for the usage report.
  - `product` string — The product for the usage report.
  - `model` string — The model 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.
    - `model` string, required — Model 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
- `404` — Resource not found
- `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)