Skip to main content
GET
/
billing
/
checkouts
Get billing checkout history
curl --request GET \
  --url https://api.videodb.io/billing/checkouts \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "data": [
    {
      "id": "cs_test_xxx",
      "amount": 100,
      "currency": "usd",
      "status": "completed",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}
Retrieve all checkout sessions initiated through your account, including their status and payment information. 
import requests

response = requests.get(
    "https://api.videodb.io/billing/checkouts",
    headers={"x-access-token": "your_api_key"}
)

checkouts = response.json()

for checkout in checkouts.get('checkouts', []):
    print(f"Checkout ID: {checkout.get('id')}")
    print(f"Amount: ${checkout.get('amount')}")
    print(f"Status: {checkout.get('status')}")
    print(f"Created: {checkout.get('created_at')}")
    print("---")
  • Checkout sessions include both completed and abandoned sessions
  • Status values include “completed”, “pending”, and “expired”
  • Completed checkouts result in credit additions to your account
  • Each checkout session is associated with a specific purchase amount

Create Checkout

Initiate a new checkout session to purchase credits

Top Up Credits

Manually add credits to your account

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

Checkout history

​
success
boolean
Example:

true

​
data
object[]