show invoices

Gets your invoices within given timerange.

Timerange is required using the select_filters.when field.

Optionally filter by invoice service using select_filters.service.

Common services : transfer, stripe_payments, bitpay, coinbase, crypto.com, instance_prepay, paypal_manual, wise_manual

Date format: select_filters.when.gte and select_filters.when.lte must be UTC epoch seconds (integers). Example range: 2026-01-01 00:00:00 UTC -> 1767225600, 2026-01-31 23:59:59 UTC -> 1769903999.

HTTP request: This is a GET endpoint that accepts JSON-encoded query parameters. URL-encode JSON values when calling directly.

GET /api/v1/invoices/?select_filters={"when":{"gte":1767225600,"lte":1769903999}}&limit=60

For pagination, pass the response next_token as after_token:

GET /api/v1/invoices/?select_filters={"when":{"gte":1767225600,"lte":1769903999}}&after_token=eyJ2YWx1ZXMiOiB7ImlkIjog...

CLI Usage: vastai show invoices-v1

GET /api/v1/invoices

show invoices

cURL

curl --request GET \
  --url https://console.vast.ai/api/v1/invoices/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "select_filters": {
    "when": {
      "gte": 1748736000,
      "lte": 1764547200
    },
    "service": {
      "eq": "<string>",
      "in": [
        "<string>"
      ],
      "notin": [
        "<string>"
      ]
    }
  },
  "latest_first": true,
  "order_by": {
    "col": "paid_on",
    "dir": "desc"
  },
  "limit": 60
}
'

200

{
  "success": true,
  "count": 2,
  "total": 42,
  "results": [
    {
      "start": 1762149123,
      "end": null,
      "type": "transfer",
      "source": "[e-mail]",
      "description": "Received credit from [e-mail]",
      "amount": 35.5,
      "metadata": {
        "invoice_id": 4829137,
        "service": "transfer",
        "sender": 123456,
        "recipient": 789012
      },
      "items": []
    },
    {
      "start": 1761980044,
      "end": 1761980301,
      "type": "credit",
      "source": "stripe",
      "description": "Manual billing from VISA ending in 4412",
      "amount": -19.99,
      "metadata": {
        "invoice_id": 4828771,
        "service": "stripe_payments",
        "last4": "4412",
        "network": "visa",
        "transfer_group": "pi_3TAbCdEfgHiJkLmN"
      },
      "items": []
    }
  ],
  "next_token": null
}

Authorizations

Authorization · string · header · required

API key must be provided in the Authorization header

Body

application/json

select_filters · object · required

Shows invoices using given filters.

Required : Filter by timerange using when field.

Use unix timestamps (UTC) comparison operators.

Example : To filter invoices from June 1, 2025 to Dec 1, 2025:

"select_filters": {
  "when": {
      "gte": 1748736000,
      "lte": 1764547200 
    }
  }

Supported operators:

• gt or gte: invoices created after this time
• lt or lte: invoices created before this time

Optional : Filter invoices by service using service field.

Supported services: transfer, stripe_payments, bitpay, coinbase, crypto.com, instance_prepay, paypal_manual, wise_manual

Supported operators:

• in : include only these services
• notin : exclude these services
• eq : matches a single service

Example: Get paypal and wise invoices only

"service": {
  "in": ["paypal_manual", "wise_manual"]
}

Show child attributes

latest_first · boolean · default: true

Sort by newest invoices first.

order_by · object[]

Sort invoices by given columns.

Supported columns: paid_on, amount_cents, when

Example : To sort by oldest invoices first

"order_by": [
  {
    "col": "when",
    "dir": "asc"
  }
]

Show child attributes

limit · integer · default: 60

Maximum number of invoices to return.

Response

200

application/json

Paginated invoice results