calculate monthly bill impact

curl --request POST \
  --url https://api.example.com/v1/homes/{id}/bill/monthly \
  --header 'Content-Type: application/json' \
  --header 'x-ws-api-key: <api-key>' \
  --data '
{
  "usage": [
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ]
  ],
  "month": 1,
  "year": 2025
}
'

{
  "billTotal": 29.303339999999988,
  "gridServicesRev": 0.3091212125,
  "CO2e": 46.1163425,
  "month": 1,
  "year": 2025
}

POST

homes

{id}

bill

monthly

calculate monthly bill impact

curl --request POST \
  --url https://api.example.com/v1/homes/{id}/bill/monthly \
  --header 'Content-Type: application/json' \
  --header 'x-ws-api-key: <api-key>' \
  --data '
{
  "usage": [
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
47,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ],
    [
09,
08,
06,
05,
07,
06,
09,
05,
06,
07,
1,
07,
05,
08,
07,
05,
1,
1,
09,
1,
05,
08,
09,
08,
26,
18,
25,
28,
35,
36,
26,
34,
21,
32,
27,
16,
19,
14,
21,
18,
08,
16,
21,
11,
13,
21,
11,
17,
11,
23,
2,
15,
09,
13,
16,
22,
09,
17,
19,
16,
2,
16,
23,
17,
17,
15,
17,
14,
39,
3,
27,
27,
4,
41,
36,
24,
44,
49,
5,
48,
49,
5,
38,
33,
43,
3,
46,
48,
25,
2,
25,
19,
18,
21,
26,
25
    ]
  ],
  "month": 1,
  "year": 2025
}
'

{
  "billTotal": 29.303339999999988,
  "gridServicesRev": 0.3091212125,
  "CO2e": 46.1163425,
  "month": 1,
  "year": 2025
}

Authorizations

x-ws-api-key

string

header

required

WattShift API key

Headers

x-ws-api-key

string

WattShift API Key

Path Parameters

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 number of days in the specified month.

Minimum array length: 1

month

integer

required

Month number (1-12, where 1 = January, 12 = December)

Required range: 1 < x < 12

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.

year

integer

Year (4 digits). If not provided, defaults to current year.

Required range: 2000 < x < 2100

debug

boolean

Enable debug mode to return additional information

Response

billTotal

number

required

Total bill amount for the calculation.

month

integer

required

Required range: 1 < x < 12

year

integer

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

get price signal open adr calculate period bill using a specific rate plan