Skip to Content
List usage export CSVs
get

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.

Request path & query params
limit
integer
(default: 25)

Number of items to include in the response

page
integer
(default: 1)

Offset by this many pages, of the size of limit

timeframe[]
array

Timeframe window to limit results by. Must be provided as an array query string parameter (e.g. timeframe[]=).

Accepted formats are...

  • array of epoch timestamps e.g. timeframe[]=1498867200&timeframe[]=1498953600
  • duration string e.g. timeframe[]=24:hours or timeframe[]=7:days
download_url_ttl
integer
(default: 3600, min: 1, max: 604800)

Lifetime in seconds for the pre-signed download URL.

get
200
https://api.mux.com/system/v1/usage/exports
Response
(application/json)
{
  "data": [
    {
      "date": "2026-03-30",
      "file_size": 1048576,
      "download_url": "https://storage.mux.com/org_abc123/2026-06-09.csv?X-Amz-Expires=3600&X-Amz-Signature=abc",
      "download_url_expires_at": 1749513600
    },
    {
      "date": "2026-03-29",
      "file_size": 983040,
      "download_url": "https://storage.mux.com/org_abc123/2026-06-08.csv?X-Amz-Expires=3600&X-Amz-Signature=def",
      "download_url_expires_at": 1749513600
    }
  ],
  "meta": {
    "page": 1,
    "pages": 16,
    "limit": 25,
    "total": 397
  }
}