---
title: "Get Usage Summary"
method: GET
path: "/v1/billing/usage-summary"
tags: ["billing"]
---

# Get Usage Summary

`GET /v1/billing/usage-summary`

Get usage summary with per-meter and daily breakdowns.

If start_date/end_date are provided (ISO format 'YYYY-MM-DD'), returns usage
for that specific range. Otherwise, defaults to the current calendar month.

## Query parameters

- `start_date` string, nullable
- `end_date` string, nullable

## Headers

- `authorization` string

## Response `200`

Successful Response

- UsageSummaryResponse
  - `billing_period_start` integer, required
  - `billing_period_end` integer, required
  - `meters` ModelsBillingMeterUsage[], required
    - `id` string, required
    - `label` string, required
    - `unit` string, required
    - `total_usage` integer, required
    - `unit_price_cents` integer, required
  - `daily_usage` DailyUsage[], required
    - `date` string, required
    - `api_video_1080p` integer
    - `api_video_720p` integer
    - `api_image_1080p` integer
    - `api_image_720p` integer
  - `estimated_cost_cents` integer, required

---

[API](https://skmtc.dev/beeble/apis/beeble-developer-api.md) · [All operations](https://skmtc.dev/beeble/apis/beeble-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beeble/beeble-developer-api/revisions/f35ce0de5d00/schema)