Skip to main content
POST
calculate period bill impact

Authorizations

x-ws-api-key
string
header
required

WattShift API key

Headers

x-ws-api-key
string

WattShift API Key

Path Parameters

id
string
required

Body

application/json
usage
number[][]
required

Array of daily usage arrays. Each inner array must have 96 values (15-minute intervals). Number of days must match the date range between startDate and endDate.

Minimum array length: 1
startDate
string
required

Start date of the billing period (YYYY-MM-DD or ISO 8601 datetime format). Must be before endDate.

endDate
string
required

End date of the billing period (YYYY-MM-DD or ISO 8601 datetime format). Must be after startDate.

export
number[][]

Optional array of daily export arrays (solar export to grid). Each inner array must have 96 values (15-minute intervals). Number of days must match usage array length.

debug
boolean

Enable debug mode to return additional information

Response

billTotal
number
required

Total bill amount for the calculation.

startDate
string
required
endDate
string
required
totalBill
number
gridServicesRev
number

Optional grid services revenue for the calculation.

exportCompensationCredit
number

Optional export compensation credit applied from resolved NEM/NBT export prices.

CO2e
number

Optional carbon dioxide equivalent emissions impact.

debugInfo
any