> ## Documentation Index > Fetch the complete documentation index at: https://docs.wattshift.com/llms.txt > Use this file to discover all available pages before exploring further. # calculate period bill with inline home context > Calculates period bill impact using inline home context instead of a persisted home id. ## OpenAPI ````yaml api-reference/openapi.json POST /v1/homes/bill/period openapi: 3.0.0 info: title: WattShift API description: An API for the WattShift Service (https://wattshift.com/partners) version: '1.0' contact: {} servers: [] security: [] tags: [] paths: /v1/homes/bill/period: post: tags: - homes summary: calculate period bill with inline home context description: >- Calculates period bill impact using inline home context instead of a persisted home id. operationId: calculatePeriodBillWithHome parameters: - name: x-ws-api-key in: header description: WattShift API Key schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PeriodBillWithHomeRequestDto' example: home: ratePlanId: 6915de25881cbc6041e4c7f1 zipcode: '94107' name: My home utilityId: '12199' solarCapacityKw: 5 usage: - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.47 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 - - 0.09 - 0.08 - 0.06 - 0.05 - 0.07 - 0.06 - 0.09 - 0.05 - 0.06 - 0.07 - 0.1 - 0.07 - 0.05 - 0.08 - 0.07 - 0.05 - 0.1 - 0.1 - 0.09 - 0.1 - 0.05 - 0.08 - 0.09 - 0.08 - 0.26 - 0.18 - 0.25 - 0.28 - 0.35 - 0.36 - 0.26 - 0.34 - 0.21 - 0.32 - 0.27 - 0.16 - 0.19 - 0.14 - 0.21 - 0.18 - 0.08 - 0.16 - 0.21 - 0.11 - 0.13 - 0.21 - 0.11 - 0.17 - 0.11 - 0.23 - 0.2 - 0.15 - 0.09 - 0.13 - 0.16 - 0.22 - 0.09 - 0.17 - 0.19 - 0.16 - 0.2 - 0.16 - 0.23 - 0.17 - 0.17 - 0.15 - 0.17 - 0.14 - 0.39 - 0.3 - 0.27 - 0.27 - 0.4 - 0.41 - 0.36 - 0.24 - 0.44 - 0.49 - 0.5 - 0.48 - 0.49 - 0.5 - 0.38 - 0.33 - 0.43 - 0.3 - 0.46 - 0.48 - 0.25 - 0.2 - 0.25 - 0.19 - 0.18 - 0.21 - 0.26 - 0.25 startDate: '2025-01-02T00:00:00.000Z' endDate: '2025-02-03T00:00:00.000Z' useDefaultUsage: false responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/PeriodBillImpactResultDto' example: billTotal: 29.303339999999988 gridServicesRev: 0.3091212125 startDate: '2025-01-02T00:00:00.000Z' endDate: '2025-02-03T00:00:00.000Z' CO2e: 46.1163425 '400': description: Validation failure content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelopeDto' example: request_id: req_123 error_code: VALIDATION_FAILED message: Request validation failed. field_errors: - field: zipcode message: zipcode is invalid '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelopeDto' example: request_id: req_123 error_code: AUTH_MISSING_API_KEY message: Missing x-ws-api-key header. recovery_action: >- Provide the x-ws-api-key header. If this contradicts the public docs or OpenAPI contract, submit structured feedback through /v1/feedback. security: - x-ws-api-key: [] - x-ws-api-key: [] components: schemas: PeriodBillWithHomeRequestDto: type: object properties: home: description: >- Home context for bill impact; persisted only for the duration of the request type: object properties: name: description: >- Display name for the temporary home row (defaults to bill-preview) type: string minLength: 1 maxLength: 255 ratePlanId: description: MongoDB rate plan id used for bill calculation type: string minLength: 1 zipcode: description: >- ZIP code for carbon impact, grid revenue, and NEM/NBT export compensation type: string pattern: ^(?:0{0,4}[0-9]{1,5}|[0-9]{3})(?:[-\s][0-9]{4})?$ carbonSignalImportance: description: >- Carbon signal weighting for the home zipcode (HIGH, MEDIUM, or LOW) type: string enum: - LOW - MEDIUM - HIGH x-enumNames: - LOW - MEDIUM - HIGH utilityId: description: Utility id for hourly realtime pricing adders type: string solarCapacityKw: description: >- Solar system size in kW used when generating default Palmetto usage type: number minimum: 0 exclusiveMinimum: false required: - ratePlanId - zipcode usage: description: >- Array of daily usage arrays. Required when useDefaultUsage is false or omitted. type: array items: type: array items: type: number export: description: >- 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. type: array items: type: array items: type: number startDate: description: >- Start date of the billing period (YYYY-MM-DD or ISO 8601 datetime format). Must be before endDate. type: string endDate: description: >- End date of the billing period (YYYY-MM-DD or ISO 8601 datetime format). Must be after startDate. type: string debug: description: Enable debug mode to return additional information type: boolean useDefaultUsage: description: >- When true, generates usage from Palmetto baseline data using home zipcode and optional solarCapacityKw instead of inline usage arrays. Defaults to false. type: boolean required: - home - startDate - endDate PeriodBillImpactResultDto: type: object properties: billTotal: description: Total bill amount for the calculation. type: number totalBill: type: number gridServicesRev: description: Optional grid services revenue for the calculation. type: number exportCompensationCredit: description: >- Optional export compensation credit applied from resolved NEM/NBT export prices. type: number CO2e: description: Optional carbon dioxide equivalent emissions impact. type: number debugInfo: {} startDate: type: string endDate: type: string required: - billTotal - startDate - endDate ApiErrorEnvelopeDto: type: object properties: request_id: type: string example: req_123 error_code: type: string enum: - AUTH_MISSING_API_KEY - AUTH_INVALID_API_KEY - AUTH_EXPIRED_CREDENTIAL - AUTH_REVOKED_CREDENTIAL - AUTH_INSUFFICIENT_SCOPE - VALIDATION_FAILED - RATE_LIMITED - NOT_FOUND - FORBIDDEN - PRODUCTION_ACCESS_DENIED - INTERNAL_ERROR example: VALIDATION_FAILED message: type: string example: Request validation failed. recovery_action: type: string example: >- Provide the x-ws-api-key header. If this contradicts the public docs, submit feedback through /v1/feedback. field_errors: type: array items: $ref: '#/components/schemas/ApiFieldErrorDto' retry_after_seconds: type: number example: 3600 required: - request_id - error_code - message ApiFieldErrorDto: type: object properties: field: type: string example: zipcode message: type: string example: zipcode is invalid required: - message securitySchemes: x-ws-api-key: type: apiKey in: header name: x-ws-api-key description: WattShift API key ````