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

# Get billing summary

`GET /v1/billing/summary`

## Request

- Base URL: `https://api.dexto.ai`
- URL: `https://api.dexto.ai/v1/billing/summary`
- Auth: HTTP bearer

Returns the caller organization's current credit balance, charged usage for the preceding 30 days, and up to 50 recent model usage events. Organization owners and admins see all members' usage; other members see only usage attributed to them.

## Response `200`

Successful response.

- object
  - `balance_usd` number, required
  - `last_30_days` object, required
    - `since` string, date-time, required
    - `total_cost_usd` number, required
    - `total_usage_events` integer, required
  - `recent_model_usage` object[], required
    - `cost_usd` number, required
    - `input_tokens` integer, required
    - `model` string, required
    - `output_tokens` integer, required
    - `timestamp` string, date-time, required

## Other responses

- `400`: Invalid JSON or request fields.
- `401`: Missing or invalid API key.
- `402`: The account has insufficient credits.
- `403`: The account cannot perform this operation.
- `404`: The requested resource was not found.
- `409`: The request conflicts with existing resource state.
- `429`: The account exceeded this operation's request rate.
- `500`: Unexpected Dexto failure.
- `502`: The upstream model provider failed.
- `503`: A required Dexto service is temporarily unavailable.

---

[API](https://skmtc.dev/dexto/apis/dexto-api.md) - [All operations](https://skmtc.dev/dexto/apis/dexto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dexto/apis/dexto-api/revisions/47eb880cffa5?raw)
