---
title: "Get Billing Usage"
method: GET
path: "/api/billing/usage"
---

# Get Billing Usage

`GET /api/billing/usage`

Get current billing period usage for the authenticated user.

Source of truth: Stripe. This fetches usage directly from Stripe's
upcoming invoice API to ensure accurate billing information.

Args:
    current_user: Authenticated user
    db: Database session
    
Returns:
    BillingUsageResponse with usage statistics from Stripe

## Response `200`

Successful Response

- BillingUsageResponse — Response schema for current billing usage
  - `success` boolean
  - `hasBilling` boolean, required
  - `totalCostCents` integer, required
  - `totalCostDollars` number, required
  - `totalVideoSeconds` number, required
  - `eventCount` integer, required
  - `periodStart` string, nullable
  - `periodEnd` string, nullable
  - `billedToUserId` string, nullable
  - `creditBalanceCents` integer
  - `creditBalanceDollars` number
  - `billingMode` string

---

[API](https://skmtc.dev/latted/apis/motion-graphics-designer-api.md) · [All operations](https://skmtc.dev/latted/apis/motion-graphics-designer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/latted/motion-graphics-designer-api/revisions/36d149b525df/schema)