Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Monthly wholesale billing CSV for your provider — every subscription active in the month, with prorated quantities.
service_provider_id parameter.
GET /partner/reports/billing?year=2026&month=7
X-API-Key: krnl_... — auto-scoped to the authenticated provider. Rate-limited
to 30 requests / minute per key.
| Parameter | Type | Notes |
|---|---|---|
year | integer | Billing year (2000 or later). Required. |
month | integer | Billing month, 1–12. Required. |
400 (month must be between 1 and 12, year must be 2000 or later).
200 OK with Content-Type: text/csv and
Content-Disposition: attachment; filename="provider-billing-YYYY-MM.csv". Columns:
| Column | Description |
|---|---|
Subscription ID | kurnl subscription id. |
Subscriber ID | kurnl subscriber id. |
External Subscription ID | your external id, if the subscription came via external checkout. |
Service Provider | provider name. |
Fee Type | always the literal Monthly. |
Quantity | prorated fraction of days active — an unrounded float (e.g. 0.3225806451612903). |
Total Cost | quantity × monthly wholesale price, rounded to 2 decimals. |
Wholesale price monthly | monthly wholesale price: the plan version’s wholesale_price_monthly, falling back to the subscription’s base_wholesale_price_monthly, else 0.0. |
Wholesale Product ID | wholesale product id. |
Wholesale Product Name | wholesale product display name. |
Location Hash | the served location. |
From Date | start of the billed window, as a naive timestamp YYYY-MM-DDT00:00:00 (no timezone suffix). |
To Date | end of the billed window, same naive YYYY-MM-DDT00:00:00 format. |
| Status | Meaning |
|---|---|
400 | Invalid month / year (see above) |
401 | Missing or invalid X-API-Key |
403 | "API access is not enabled for this account" |
429 | Rate limit exceeded (30/min) |
curl -L "https://middleware.bso-projects.com/partner/reports/billing?year=2026&month=7" \
-H "X-API-Key: krnl_your_key" \
-o wholesale-2026-07.csv
1/31, and one active for
the 10th through the 19th bills at 10/31. Cancelled-mid-month subscriptions
still appear for the days they were active.