Skip to main content
GET
/
api
/
v1
/
billing
/
records
List billing ledger records
curl --request GET \
  --url http://localhost:3051/api/v1/billing/records \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://docs.omnifence.ai/llms.txt

Use this file to discover all available pages before exploring further.

Paginated history of charges, credits, and refunds against your prepaid balance. Each record represents one of:
  • charge — a per-call cost deducted from your balance.
  • credit — a top-up added to your balance.
  • refund — a previously charged request refunded after permanent failure.
  • stripe_refund — a top-up reversed via Stripe.

​
Filtering by type

Pass the type query parameter to return only records of a given type. Multiple types can be combined as a comma-separated list: 
GET /api/v1/billing/records?type=charge
GET /api/v1/billing/records?type=refund,stripe_refund
Unknown values return 400 INVALID_REQUEST.

​
Pagination

Use the cursor returned in next_cursor to fetch the next page. The type filter must be repeated on each follow-up request — cursors do not encode the filter.

Authorizations

​
Authorization
string
header
required

API key from the Stars dashboard

Query Parameters

​
limit
string
​
cursor
string
​
type
string

Comma-separated list of record types to include. Valid values: charge, credit, refund, stripe_refund.

Response

200

Default Response