Reconciliation tariffs

Base URL: $BUSINESS_API

List unit-volume reconciliation pricing rules

Logs

GET /reconciliation-tariffs

Returns a cursor-paginated page of reconciliation tariffs, which set the retail price per unit volume, the utility's price per cubic metre and the variance tolerance used when reconciling metered resale. Filter with status and page with limit and after. Requires business:reconciliations:read.

Parameters

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

Returns

200 OK

Permissions business:reconciliations:read · Roles: admin, analyst, customer_service, finance, operations, owner, viewer

curl -X GET "$BUSINESS_API/reconciliation-tariffs" \
  -H "Authorization: Bearer sk_test_..."
Response 200

OK

Create a unit-volume reconciliation pricing rule

Logs

POST /reconciliation-tariffs

Creates an active reconciliation tariff from effective_from onwards; settlements use the latest active tariff in effect at the reconciled period's end. name, currency, effective_from and a positive retail_cents_per_unit are required, unit_litres defaults to 1000, and tolerance_bp must be between 0 and 10000; invalid values return 400. When utility_cents_per_m3 is omitted, wholesale_cents_per_m3 is used in its place. Requires business:reconciliations:settle.

Returns

201 Reconciliation pricing tariff created

Show attributes
idstring · required
tenant_idstring · required
namestring · required
unit_litresinteger (int64) · required
retail_cents_per_unitinteger (int64) · required
utility_cents_per_m3integer (int64) · required
tolerance_bpinteger · required
currencystring · required
effective_fromstring (date-time) · required
statusstring · required

Permissions business:reconciliations:settle · Roles: admin, finance, owner

curl -X POST "$BUSINESS_API/reconciliation-tariffs" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{}'
Response 201
{
  "id": "idx_2xBW8Tr0oR5YsrNoIdzQO7t4Gjn",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "name": "Ana Matsinhe",
  "unit_litres": 1,
  "retail_cents_per_unit": 1,
  "utility_cents_per_m3": 1,
  "tolerance_bp": 1,
  "currency": "MZN",
  "effective_from": "2026-11-19T09:30:00Z",
  "status": "active"
}