---
title: blossom billing:usage:export
url: "/docs/reference/cli/billing/usage/export/"
canonical_url: https://docs.blossom88.com/docs/reference/cli/billing/usage/export/
markdown_url: https://docs.blossom88.com/docs/reference/cli/billing/usage/export.md
summary: Export billing usage CSV
categories:
- cli
- reference
---

# blossom billing:usage:export

Export billing usage CSV

## Usage

    blossom billing:usage:export [--month MONTH] [--period-range PERIOD_RANGE]

## Flags

| Flag | Description |
| --- | --- |
| `--month` | Month to export, formatted YYYY-MM |
| `--period-range` | Billing period as start_timestamp,end_timestamp |

Examples:

    blossom billing:usage:export
    blossom billing:usage:export --month 2026-06
    blossom billing:usage:export --period-range 1780272000,1782864000

Prints raw billing usage records as CSV. The export is separate from
`billing:usage` so humans can review summaries by default and billing-sensitive
users can send raw records directly to files, spreadsheets, or reconciliation
tools.

The CSV includes readable usage, raw meter quantities, list price, discount,
Blossom charge, reporting status, and preserved Account and workload identity.

Defaults:

    period: current billing period

CSV is the only supported export format.