> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-auto-cli-sdk-preview-pr-398.mintlify.site/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="--invoices" type="boolean">
  Show invoices instead of charges
</ParamField>

<ParamField path="--invoice-type" type="string">
  Filter which types of invoices to show: {transfers, stripe, bitpay, coinbase, crypto.com, reserved, payout_paypal, payout_wise}
  Allowed values: transfers, stripe, bitpay, coinbase, crypto.com, reserved, payout\_paypal, payout\_wise
</ParamField>

<ParamField path="--charges" type="boolean">
  Show charges instead of invoices
</ParamField>

<ParamField path="--charge-type" type="string">
  Filter which types of charges to show: {i|instance, v|volume, s|serverless}
  Allowed values: instance, volume, serverless, i, v, s
</ParamField>

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

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

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

<ParamField path="--next-token" type="string">
  Pagination token for next page
</ParamField>

<ParamField path="--format" type="string" default="table">
  Output format for charges (default: table)
  Allowed values: table, tree
</ParamField>

<ParamField path="--verbose" type="boolean">
  Include full Instance Charge details and Invoice Metadata (tree view only)
</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  (note: 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  (note: type/date filters MUST match previous request for pagination to work)
    vastai show invoices-v1 --invoices --limit 50 --next-token eyJ2YWx1ZXMiOiB7ImlkIjogMjUwNzgyMzR9LCAib3NfcGFnZSI6IDB9

    # Show the last 10 instance (only) charges over a 7 day period ending in 2025-12-25, sorted by latest charges 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`) |