doclinth

Usage-based invoice

Pack 01 · SaaS billing · A4

A high-trust usage invoice for API and infrastructure products. It exposes the rating inputs customers need to verify a charge without dumping raw telemetry into the document.

  1. Included, measured and billable units
  2. Meter ids and pricing bases
  3. Usage roll-up metrics
  4. Immutable export reference for disputes
Use this template →Seeds into your account on signup. No setup.Have your own PDF? Import it →

Example data

The data payload this template expects. Generate usage-based invoice PDFs by POSTing a shape like this to /v1/generate.

sample_data.json
{
  "invoice_number": "ARC-U-11804",
  "usage_period": "June 2026",
  "currency": "USD",
  "issue_date": "2026-07-01",
  "due_date": "2026-07-05",
  "period_closed_at": "2026-07-01",
  "company": {
    "name": "Arcwell"
  },
  "customer": {
    "company": "Fathom Research",
    "account_id": "acct_FTM_0184"
  },
  "summary": {
    "api_calls": 4827612,
    "documents": 18420,
    "compute_minutes": 7821
  },
  "meters": [
    {
      "name": "API requests",
      "meter_id": "mtr_api_v2",
      "basis": "per 1K calls",
      "included": 2000000,
      "measured": 4827612,
      "billable": 2828,
      "rate": 0.14,
      "charge": 395.92
    },
    {
      "name": "Documents generated",
      "meter_id": "mtr_docs",
      "basis": "per document",
      "included": 10000,
      "measured": 18420,
      "billable": 8420,
      "rate": 0.045,
      "charge": 378.9
    },
    {
      "name": "Compute minutes",
      "meter_id": "mtr_compute",
      "basis": "per minute",
      "included": 5000,
      "measured": 7821,
      "billable": 2821,
      "rate": 0.035,
      "charge": 98.74
    }
  ],
  "platform_fee": 899,
  "usage_charges": 873.56,
  "tax": 354.51,
  "total": 2127.07,
  "payment_method": "Visa •••• 1842",
  "audit_note": "Meter values are frozen at period close. The export id below resolves to the immutable usage ledger.",
  "usage_export_id": "uxp_01J2W8M3QK91"
}
generate.sh
curl -X POST https://doclinth.com/v1/generate \
  -H "Authorization: Bearer dl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template_id":"YOUR_TEMPLATE_ID","data":{"invoice_number":"ARC-U-11804","usage_period":"June 2026","currency":"USD","issue_date":"2026-07-01","due_date":"2026-07-05","period_closed_at":"2026-07-01","company":{"name":"Arcwell"},"customer":{"company":"Fathom Research","account_id":"acct_FTM_0184"},"summary":{"api_calls":4827612,"documents":18420,"compute_minutes":7821},"meters":[{"name":"API requests","meter_id":"mtr_api_v2","basis":"per 1K calls","included":2000000,"measured":4827612,"billable":2828,"rate":0.14,"charge":395.92},{"name":"Documents generated","meter_id":"mtr_docs","basis":"per document","included":10000,"measured":18420,"billable":8420,"rate":0.045,"charge":378.9},{"name":"Compute minutes","meter_id":"mtr_compute","basis":"per minute","included":5000,"measured":7821,"billable":2821,"rate":0.035,"charge":98.74}],"platform_fee":899,"usage_charges":873.56,"tax":354.51,"total":2127.07,"payment_method":"Visa •••• 1842","audit_note":"Meter values are frozen at period close. The export id below resolves to the immutable usage ledger.","usage_export_id":"uxp_01J2W8M3QK91"}}'

Sign up to seed this template and get its template_id.

Related templates