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

# Get billing summary

`GET /v1/billing/summary`

## Response `200`

Billing summary for the current period

- BillingPeriodSummary — High level billing summary for the currently active period.
  - `period` Period, required — Inclusive/exclusive window describing a billing period.
    - `start` string, date-time, required — The start of the billing period
    - `end` string, date-time, required — The end of the billing period
  - `cost` CostInfo, required — Cost information for a billing period. - net_usage_cost: portion of usage that actually ends up on the invoice after credits, computed as gross_usage_cost - balance_applied. - gross_usage_cost: metered usage value before balance applied.
    - `net_usage_cost` string — The net usage cost
    - `gross_usage_cost` string — The gross usage cost
    - `balance_applied` string — The balance applied
    - `phases` PhaseCostInfo[] — The cost for each phase in descending order of end date
      - `period` Period, required — Inclusive/exclusive window describing a billing period.
        - `start` string, date-time, required — The start of the billing period
        - `end` string, date-time, required — The end of the billing period
      - `net_usage_cost` string, required — The net usage cost
      - `gross_usage_cost` string, required — The gross usage cost
      - `balance_applied` string, required — The balance applied
    - `products` ProductCostInfo[] — The cost for each product. Store, Parsing, Reranking, Embeddings
      - `product_name` string, required — The name of the product. Store, Parsing, Reranking, Embeddings
      - `gross_usage_cost` string, required — The gross usage cost of the product
      - `net_usage_cost` string, required — The net usage cost of the product
      - `balance_applied` string, required — The balance applied to the product
  - `balance` BalanceInfo, required — Information about an organization's credit balance.
    - `current_balance` number — The current balance
    - `next_effective_balance` number — The next effective balance
    - `next_effective_date` string, date-time, nullable — The next effective date
  - `usages` object, required — The monthly usages information per metric
  - `generated_at` string, date-time, required — The date and time the summary was generated

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/f66774ddecfc/schema)