# Get billing summary for one reporting period

**GET** `/v1/billing/summary`

**Operation ID**: `getSummary`
**Summary**: Get billing summary for one reporting period
Returns the per-period payload — contract bounds, reporting-period descriptor, and plan-specific commitment summary — for the authenticated user's organization. When no period is supplied, defaults to the period containing today.

## Tags
- Billing
## Parameters

- **period** (optional) - query
  - Canonical period id ("YYYY-MM-DD", the period's start date) for both monthly and annual plans. Defaults to the period containing today when omitted.
  - Type: string

## Responses

### 200

Contract + reporting period + plan summary.

- **Content-Type**: `application/json` / `BillingSummaryResponse`
### 401

Unauthorized

### 403

Forbidden

### 404

No billing record exists, no eligible subscription owns the requested period, or the subscription's plan template is unrecognized.

### 500

Internal Server Error