Billing API

Read your current-period lift and historical invoices programmatically. Useful for pulling numbers into your own finance dashboard. Confirm exact paths in your dashboard.

Current period

GET https://api.qyren.ai/v1/billing/current
Authorization: Bearer qyr_live_<your-key>

Response:

{
  "period_start": "2026-04-01T00:00:00Z",
  "period_end": "2026-04-30T23:59:59Z",
  "plan": "growth_founding",
  "base_fee_usd": 249.00,
  "lift": {
    "qyren_players": 45000,
    "qyren_arpu": 0.42,
    "holdout_players": 5000,
    "holdout_arpu": 0.31,
    "lift_percent": 35.48,
    "incremental_revenue_usd": 4950.00,
    "lift_rate": 0.15,
    "projected_lift_fee_usd": 742.50
  },
  "projected_total_usd": 991.50
}

Numbers update daily (end-of-day UTC).

Invoice history

GET https://api.qyren.ai/v1/billing/invoices

Returns the last 24 months of issued invoices with line items, status (paid, pending, overdue), and a URL to the PDF.

Raw CSV

Not available over API — download from the dashboard’s Billing tab. The CSV has one row per player per day with their group assignment, revenue, and impressions, so you can fully reconstruct the lift calculation yourself.

Rate limits

Billing endpoints: 30 requests per minute. The underlying data only updates daily; no reason to poll faster than hourly.

Getting Started

Core Concepts

Economy Health

Recommendations

Billing

Integration

API Reference

Glossary

Current period

Invoice history

Raw CSV

Rate limits

​Current period

​Invoice history

​Raw CSV

​Rate limits

Current period

Invoice history

Raw CSV

Rate limits