GET /reports/billing - kurnl Developer Docs

Download a wholesale billing CSV for a given month. Every subscription that was active at any point in the month is included, with prorated quantities so a mid-month start/stop is billed for the days it was live. The provider is taken from your API key — there is no service_provider_id parameter.

Endpoint

GET /partner/reports/billing?year=2026&month=7

Authentication

X-API-Key: krnl_... — auto-scoped to the authenticated provider. Rate-limited to 30 requests / minute per key.

Query parameters

Parameter	Type	Notes
`year`	integer	Billing year (`2000` or later). Required.
`month`	integer	Billing month, `1`–`12`. Required.

Invalid values return 400 (month must be between 1 and 12, year must be 2000 or later).

Response

200 OK with Content-Type: text/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`	the wholesale fee being billed.
`Quantity`	prorated quantity for the month (fraction of days active).
`Total Cost`	quantity × monthly wholesale price.
`Wholesale price monthly`	the wholesale product’s monthly price.
`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 within the month.
`To Date`	end of the billed window within the month.

Example

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

Quantities are prorated by day: a subscription active for 10 days of a 31-day month bills at 10/31. Cancelled-mid-month subscriptions still appear for the days they were active.