---
title: "Get current billing period cost breakdown for the billing page."
method: GET
path: "/usage/v2/billing-overview/"
tags: ["usage"]
---

# Get current billing period cost breakdown for the billing page.

`GET /usage/v2/billing-overview/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/usage/v2/billing-overview/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Returns platform fee + per-dimension costs + credits + total.

## Response `200`

OK

- UsageBillingOverviewResponse
  - `status` boolean, required
  - `result` UsageBillingOverviewResult, required
    - `org_id` string, uuid
    - `period` string
    - `plan` string
    - `platform_fee` string, decimal
    - `usage_total` string, decimal
    - `credits_applied` string, decimal
    - `subtotal` string, decimal
    - `tax` string, decimal
    - `total` string, decimal
    - `line_items` UsageInvoiceLineItem[]
      - `line_type` string, required
      - `dimension` string, nullable
      - `description` string, required
      - `quantity` string, decimal, required
      - `unit` string
      - `unit_price` string, decimal, required
      - `amount` string, decimal, required
      - `tier_breakdown` object, nullable
      - `credit_id` integer
    - `error` string
    - `pending_cancel` boolean
    - `cancel_at` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)