---
title: "List usage report exports"
method: GET
path: "/enterprises/{enterprise}/settings/billing/reports"
tags: ["billing"]
---

# List usage report exports

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

Lists all usage report exports for an enterprise. Completed and failed report exports are available for 31 days after completion or failure. This retention period applies only to generated report records. New reports can include eligible usage data from up to 24 months ago, subject to the enterprise's creation or migration date and the report type's date-range limits. The authenticated user must be an enterprise admin or billing manager, or a custom role holder with fine-grained read access to enterprise billing. An installation access token for a GitHub App installed on the enterprise with write access to enterprise administration, or with read access to enterprise billing, can also list usage report exports.

## Path parameters

- `enterprise` string, required

## Response `200`

List of usage report exports

- UsageReportExportList
  - `usage_report_exports` UsageReportExport[], required — List of usage report exports
    - `id` string, uuid, required — Unique identifier for the usage report export
    - `report_type` 'detailed' | 'summarized' | 'premium_request' | 'ai_credit', required — The type of usage report
    - `start_date` string, date, required — The start date for the report
    - `end_date` string, date, required — The end date for the report
    - `status` 'processing' | 'completed' | 'failed', required — The current status of the report export
    - `download_urls` string[] — URLs to download the completed report. Only present when the report status is `completed`.
    - `created_at` string, date-time — When the report export was created
    - `actor` string — The login of the user who requested the export

## Other responses

- `401` — Requires authentication
- `403` — Forbidden
- `404` — Resource not found
- `500` — Internal Error
- `503` — Service unavailable

## Changes

- **2026-05-29** `28fbf7b9a486` — 1 warning
  - added the new `ai_credit` enum value to the `usage_report_exports/items/report_type` response property for the response status `200`

[Change history](https://skmtc.dev/github/apis/enterprise-cloud/changes/enterprises/:enterprise/settings/billing/reports/get.md)

---

[API](https://skmtc.dev/github/apis/enterprise-cloud.md) · [All operations](https://skmtc.dev/github/apis/enterprise-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/github/apis/enterprise-cloud/revisions/e9af1ee5b414?raw)