---
title: "show invoices"
method: GET
path: "/api/v1/invoices/"
tags: ["Billing"]
---

# show invoices

`GET /api/v1/invoices/`

Returns Stripe top-ups, transfers, payouts, coinbase payments, and other billing transactions. For per-instance cost breakdowns, use [show charges](/api-reference/billing/show-charges) instead.

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

## Query parameters

- `select_filters` string, required
- `order_by` string
- `latest_first` boolean
- `limit` integer
- `after_token` string

## Response `200`

Invoice results. A missing or invalid `when` range also returns HTTP 200 with `success: false`.

- object
  - `success` boolean
  - `count` integer — Number of invoices returned in this page.
  - `total` integer — Total number of invoices matching the filters.
  - `next_token` string, nullable — Token for the next page. `null` when no more pages.
  - `results` object[] — List of invoice entries.
    - `start` number — Invoice creation time (unix seconds UTC).
    - `end` number, nullable — Payment time (unix seconds UTC). `null` if unpaid.
    - `type` string — Invoice type. `credit`, `transfer`, `payout`, `refund`, `reserved`.
    - `source` string — Payment source, e.g. `stripe`, `coinbase`, or sender email for transfers.
    - `description` string
    - `amount` number — Amount in dollars. Negative for charges, positive for transfers/payouts.
    - `metadata` object — Additional details depending on service type.
      - `invoice_id` integer
      - `service` string
    - `items` unknown[] — Always empty for invoices.
      - unknown

## Other responses

- `400` — Invalid request, e.g. malformed `after_token`.
- `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)