How to Check Billings

How to Check Billings

View your WaveSpeedAI billing history via API.

Endpoint

GET https://api.wavespeed.ai/api/v3/account/billings

Request

curl --location --request GET 'https://api.wavespeed.ai/api/v3/account/billings' \
--header 'Authorization: Bearer ${WAVESPEED_API_KEY}'

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "items": [
      {
        "id": "txn_abc123",
        "type": "topup",
        "amount": 100.00,
        "currency": "USD",
        "status": "completed",
        "payment_method": "stripe",
        "created_at": "2024-01-15T10:30:00.000Z"
      },
      {
        "id": "txn_def456",
        "type": "usage",
        "amount": -15.50,
        "currency": "USD",
        "status": "completed",
        "model": "wavespeed-ai/flux-dev",
        "created_at": "2024-01-15T11:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 150
    }
  }
}

Response Fields

FieldTypeDescription
idstringTransaction ID
typestringtopup or usage
amountnumberAmount (negative for usage)
statusstringTransaction status
payment_methodstringPayment method (for topups)
modelstringModel used (for usage)
created_atstringTransaction timestamp

Query Parameters

ParameterDescriptionExample
pagePage number1
page_sizeItems per page50
typeFilter by typetopup or usage
start_dateStart date2024-01-01
end_dateEnd date2024-01-31

Example: Filter by Type

# Get only top-ups
curl --location --request GET 'https://api.wavespeed.ai/api/v3/account/billings?type=topup' \
--header 'Authorization: Bearer ${WAVESPEED_API_KEY}'

Python Example

import os
import requests
 
api_key = os.environ.get("WAVESPEED_API_KEY")
 
def get_billings(page=1, type=None):
    params = {"page": page}
    if type:
        params["type"] = type
 
    response = requests.get(
        "https://api.wavespeed.ai/api/v3/account/billings",
        headers={"Authorization": f"Bearer {api_key}"},
        params=params
    )
    return response.json()["data"]
 
# Get recent transactions
billings = get_billings()
 
for item in billings["items"]:
    sign = "+" if item["type"] == "topup" else ""
    print(f"{item['created_at']}: {sign}${item['amount']} ({item['type']})")

Use Cases

Use CaseImplementation
Audit trailTrack all transactions
Expense reportsExport for accounting
Payment historyReview top-up history
Usage analysisAnalyze spending patterns

Invoices

For formal invoices, contact support@wavespeed.ai with:

  • Account email
  • Billing period
  • Business information
© 2025 WaveSpeedAI. All rights reserved.