Skip to main content
GET
/
billing
/
invoices
Get billing invoices
curl --request GET \
  --url https://api.videodb.io/billing/invoices \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": [
    {
      "id": "in_xxx",
      "amount": 100,
      "currency": "usd",
      "status": "paid",
      "pdf_url": "https://invoice.stripe.com/pdf/xxx",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}
Retrieve a list of all invoices and payment records for your account, including dates, amounts, and payment status. 
import videodb

conn = videodb.connect(api_key="your_api_key")

# Get all invoices
invoices = conn.get_invoices()

for invoice in invoices:
    print(f"Invoice ID: {invoice.get('id')}")
    print(f"Amount: ${invoice.get('amount')}")
    print(f"Date: {invoice.get('date')}")
    print(f"Status: {invoice.get('status')}")
    print("---")
  • Invoices are generated monthly based on your billing cycle
  • Each invoice includes itemized charges for different operations and features
  • Payment status may be “paid”, “pending”, or “failed”
  • Invoices are available for the current billing period and all previous periods

Billing Overview

Manage billing and usage information

Get Usage Statistics

Check current usage and credit consumption

Authorizations

​
x-access-token
string
header
required

API key for authentication (sk-xxx format)

Query Parameters

​
limit
integer
Example:

10

​
offset
integer
Example:

0

Response

200 - application/json

Invoice list

​
success
boolean
Example:

true

​
data
object[]