---
title: "show charges"
method: GET
path: "/api/v0/charges/"
tags: ["Billing"]
---

# show charges

`GET /api/v0/charges/`

Shows charges per instance, including GPU, storage, and bandwidth. For invoice/payment records (Stripe top-ups, transfers, payouts), use [show invoices](/api-reference/billing/show-invoices) instead.

CLI: `vastai show invoices-v1 --charges`

## Query parameters

- `select_filters` string, required
- `format` 'table' | 'tree'
- `latest_first` boolean
- `limit` integer
- `after_token` string

## Response `200`

Paginated per-instance charge results

- object
  - `success` boolean
  - `count` integer — Number of contracts returned in this page.
  - `total` integer — Total number of contracts matching the filters.
  - `next_token` string, nullable — Pagination cursor for the next page. `null` when no more pages.
  - `results` object[] — List of per-contract charge entries.
    - `start` integer — Contract start time (unix seconds UTC).
    - `end` integer — Contract end time (unix seconds UTC).
    - `type` string — Contract type. `instance` or `volume` in table format, or `serverless` (wrapper) in tree format.
    - `source` string — Identifier in the form `{type}-{id}`. For tree-format serverless wrappers, uses `endpoint-<id>` or `workergroup-<id>`.
    - `description` string
    - `amount` number, float — Total charge for this contract (rounded to 3 decimals).
    - `metadata` object — Optional instance metadata. Keys present only when non-null on the contract.
      - `template_id` integer
      - `label` string
      - `endpoint_id` integer
      - `workergroup_id` integer
    - `items` object[] — Per-charge-type breakdown (`gpu`, `disk`, `bwd`, `bwu`). Empty for tree-format wrappers above the contract level.
      - `start` integer
      - `end` integer
      - `type` 'gpu' | 'disk' | 'bwd' | 'bwu'
      - `source` string, nullable
      - `description` string
      - `amount` number, float
      - `metadata` object
      - `items` unknown[]
        - unknown

## Other responses

- `400` — Invalid request. Returned when the required `day.gte` / `day.lte` filters are missing, or when the supplied `after_token` cannot be decoded.
- `401` — Unauthorized. May be returned in framework-level authentication failure cases.
- `403` — Forbidden. Returned when no `Authorization` header is provided.
- `404` — Not Found. Returned when the supplied API key does not match any user.
- `429` — Too Many Requests

---

[API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/revisions/4ed14f79f796/schema)