VastAI.show_invoices_v1

Get billing history reports with advanced filtering and pagination.

Signature

VastAI.show_invoices_v1(
    invoices: bool = False,
    invoice_type: Optional[str] = None,
    charges: bool = False,
    charge_type: Optional[str] = None,
    start_date: Optional[str] = None,
    end_date: Optional[str] = None,
    limit: Optional[int] = 20,
    next_token: Optional[str] = None,
    format: Optional[str] = 'table',
    verbose: bool = False,
    latest_first: bool = False
) -> dict

Parameters

invoices · bool

Show invoices instead of charges

invoice_type · Optional[str]

Filter which types of invoices to show:

charges · bool

Show charges instead of invoices

charge_type · Optional[str]

Filter which types of charges to show:

start_date · Optional[str]

Start date (YYYY-MM-DD or timestamp)

end_date · Optional[str]

End date (YYYY-MM-DD or timestamp)

limit · Optional[int] · default: "20"

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

next_token · Optional[str]

Pagination token for next page

format · Optional[str] · default: "table"

Output format for charges (default: table)

verbose · bool

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

latest_first · bool

Sort by latest first

Returns

dict

Example

from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
result = client.show_invoices_v1()
print(result)