vastai show invoices-v1

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

Usage

vastai show invoices-v1 [OPTIONS]

Options

--invoices · boolean

Show invoices instead of charges

--invoice-type · string

Filter which types of invoices to show: Allowed values: transfers, stripe, bitpay, coinbase, crypto.com, reserved, payout_paypal, payout_wise

--charges · boolean

Show charges instead of invoices

--charge-type · string

Filter which types of charges to show: Allowed values: instance, volume, serverless, i, v, s

--start-date · string

Start date (YYYY-MM-DD or timestamp)

--end-date · string

End date (YYYY-MM-DD or timestamp)

--limit · integer · default: "20"

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

--next-token · string

Pagination token for next page

--format · string · default: "table"

Output format for charges (default: table) Allowed values: table, tree

--verbose · boolean

Include full Instance Charge details and Invoice Metadata (tree view only)

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