Billing
Usage and entitlement billing: per-tenant invoices assembled from what the parts recorded.
appLines of business20 operationsid billing
How it sits
An app is already assembled from parts, with a face of its own. The counts and the links below are from the platform's spec and the other services' own descriptions.
What it can do
20 operations in 9 resources, as the spec declares them. Each row is one call; paths are relative to the part.
invoices
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/invoices | List persisted invoices |
| POST | /api/v1/invoices | Generate + persist an invoice |
| POST | /api/v1/invoices/preview | Build an invoice without persisting |
| DELETE | /api/v1/invoices/{invoice_id} | Soft-delete an invoice |
| GET | /api/v1/invoices/{invoice_id} | Get a persisted invoice |
| POST | /api/v1/invoices/{invoice_id}/handoff | Hand a persisted invoice to Square as a Square DRAFT |
| GET | /api/v1/invoices/{invoice_id}/square | Refresh + read an invoice's Square status from Square |
7 operations
grants
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/grants | Show the tenant → bundle grant ledger |
| POST | /api/v1/grants | Grant an App Bundle to a tenant |
| DELETE | /api/v1/grants/{tenant}/{bundle} | Revoke a granted App Bundle |
3 operations
ledger
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/ledger | List ledger entries |
| POST | /api/v1/ledger/run | Generate + persist invoices for every tenant |
| GET | /api/v1/ledger/summary | Rolled-up invoice ledger |
3 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
bundles
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/bundles | List the canonical App-Bundle catalog |
1 operation
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
ratecard
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/ratecard | Get the rate card |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
tenants
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/tenants | List known tenants |
1 operation
All the partsLines of businessThe platform's own id for this service is cbbilling.
forge-catalog.json, generated Oct 30, 2026