---
title: "List usage export CSVs"
method: GET
path: "/system/v1/usage/exports"
tags: ["Usage Exports"]
---

# List usage export CSVs

`GET /system/v1/usage/exports`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/system/v1/usage/exports`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Lists available billing usage exports for your organization along with pre-signed download URLs, sorted newest first. CSVs are available for dates between 400 days ago and yesterday.

## Query parameters

- `limit` integer
- `page` integer
- `timeframe` string[]
- `download_url_ttl` integer

## Response `200`

OK

- ListUsageExportsResponse
  - `data` UsageExport[], required
    - `date` string, date, required: The calendar date this CSV covers, in `YYYY-MM-DD` format.
    - `file_size` integer, nullable, required: Uncompressed size of the CSV file in bytes. May be `null` if the size is unavailable.
    - `download_url` string, required: A pre-signed URL to download the CSV. Valid until `download_url_expires_at`.
    - `download_url_expires_at` integer, required: Unix timestamp (seconds since epoch) at which `download_url` expires.
  - `meta` UsageExportsMeta, required
    - `page` integer, required: Current page number (1-based).
    - `pages` integer, required: Total number of pages.
    - `limit` integer, required: Maximum number of items per page.
    - `total` integer, required: Total number of available export files matching the query.

## Other responses

- `400`: Bad Request – an invalid `timeframe` or `download_url_ttl` value was provided.
- `401`: Unauthorized
- `403`: Forbidden – the Usage CSV Export feature is not enabled for your organization. Enable it in the Mux Dashboard under **Usage > Exports**.
- `404`: Not Found – no usage CSVs exist for the specified `timeframe`.
- `412`: Precondition Failed – one or more usage CSVs for the specified `timeframe` are still being generated. Retry after a short delay.
- `429`: Rate limited

## Changes

- **2026-09-30** `99c1d509dcbb`: 1 warning, 1 info
  - deleted the `query` request parameter `timeframe[]`
  - added the new optional `query` request parameter `timeframe`
- **2026-08-12** `5b4b3133f27d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/system/v1/usage/exports/get.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)