vastai show invoices-v1

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

Usage

vastai show invoices-v1 [OPTIONS]

Options

-i · boolean

Show invoices instead of charges (alias: --invoices)

-it · string

Filter which types of invoices to show (alias: --invoice-type). Choices: transfers, stripe, bitpay, coinbase, crypto.com, reserved, payout_paypal, payout_wise

-c · boolean

Show charges instead of invoices (alias: --charges)

-ct · string

Filter which types of charges to show (alias: --charge-type). Choices: instance, volume, serverless, i, v, s

-s · string

Start date (YYYY-MM-DD or timestamp) (alias: --start-date)

-e · string

End date (YYYY-MM-DD or timestamp) (alias: --end-date)

-l · integer · default: "20"

Number of results per page (default: 20, max: 100) (alias: --limit)

-t · string

Pagination token for next page (alias: --next-token)

-f · string · default: "table"

Output format for charges (default: table) (alias: --format) Choices: table, tree

-v · boolean

Include full Instance Charge details and Invoice Metadata (tree view only) (alias: --verbose)

--latest-first · boolean

Sort by latest first

Description

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

Examples

# 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)