> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vast.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# vastai show invoices-v1

Get billing (invoices/charges) history reports with advanced filtering and pagination

## Usage

```bash theme={null}
vastai show invoices-v1 [OPTIONS]
```

## Options

<ParamField path="-i" type="boolean">
  Show invoices instead of charges (alias: `--invoices`)
</ParamField>

<ParamField path="-it" type="string">
  Filter which types of invoices to show (alias: `--invoice-type`). Choices: `transfers`, `stripe`, `bitpay`, `coinbase`, `crypto.com`, `reserved`, `payout_paypal`, `payout_wise`
</ParamField>

<ParamField path="-c" type="boolean">
  Show charges instead of invoices (alias: `--charges`)
</ParamField>

<ParamField path="-ct" type="string">
  Filter which types of charges to show (alias: `--charge-type`). Choices: `instance`, `volume`, `serverless`, `i`, `v`, `s`
</ParamField>

<ParamField path="-s" type="string">
  Start date (YYYY-MM-DD or timestamp) (alias: `--start-date`)
</ParamField>

<ParamField path="-e" type="string">
  End date (YYYY-MM-DD or timestamp) (alias: `--end-date`)
</ParamField>

<ParamField path="-l" type="integer" default="20">
  Number of results per page (default: 20, max: 100) (alias: `--limit`)
</ParamField>

<ParamField path="-t" type="string">
  Pagination token for next page (alias: `--next-token`)
</ParamField>

<ParamField path="-f" type="string" default="table">
  Output format for charges (default: table) (alias: `--format`) Choices: `table`, `tree`
</ParamField>

<ParamField path="-v" type="boolean">
  Include full Instance Charge details and Invoice Metadata (tree view only) (alias: `--verbose`)
</ParamField>

<ParamField path="--latest-first" type="boolean">
  Sort by latest first
</ParamField>

## Description

This command supports colored output and rich formatting if the 'rich' python module is installed!

## Examples

```bash theme={null}
# Show the first 20 invoices in the last week (default window is a 7 day period ending today)
vastai show invoices-v1 --invoices

# Show the first 50 charges over a 7 day period starting from 2025-11-30 in tree format
vastai show invoices-v1 --charges -s 2025-11-30 -f tree -l 50

# Show the first 20 invoices of specific types for the month of November 2025
vastai show invoices-v1 -i -it stripe bitpay transfers --start-date 2025-11-01 --end-date 2025-11-30

# Show the first 20 charges for only volumes and serverless instances between two dates, including all details and metadata
vastai show invoices-v1 -c --charge-type v s -s 2025-11-01 -e 2025-11-05 --format tree --verbose

# Get the next page of paginated invoices, limit to 50 per page (type/date filters MUST match previous request)
vastai show invoices-v1 --invoices --limit 50 --next-token eyJ2YWx1ZXMiOiB7ImlkIjogMjUwNzgyMzR9LCAib3NfcGFnZSI6IDB9

# Show the last 10 instance charges over a 7 day period ending 2025-12-25, sorted latest first
vastai show invoices-v1 --charges -ct instance --end-date 2025-12-25 -l 10 --latest-first
```

## Global Options

The following options are available for all commands:

| Option          | Description                                           |
| --------------- | ----------------------------------------------------- |
| `--url URL`     | Server REST API URL                                   |
| `--retry N`     | Retry limit                                           |
| `--raw`         | Output machine-readable JSON                          |
| `--explain`     | Verbose explanation of API calls                      |
| `--api-key KEY` | API key (defaults to `~/.config/vastai/vast_api_key`) |