---
title: "Get bills"
method: GET
path: "/bills"
tags: ["Bills"]
---

# Get bills

`GET /bills`

Get all bills for all Accounts for the given User, ordered by `statement_date` desc.

## Query parameters

- `account_id` string

## Headers

- `Authorization` string, required
- `Pelm-Client-Id` string, required
- `Pelm-Secret` string, required

## Response `200`

Successful operation

- object[]
  - `account_id` string — ID of account that bills belong to
  - `bills` Bill[] — Bills for account
    - `id` string
    - `account_id` string
    - `start_date` string
    - `end_date` string
    - `statement_date` string
    - `due_date` string
    - `payment_date` string — Date the bill is set to be paid if auto-pay is enabled.
    - `total_amount_due` number — Total amount due for this bill, which is equivalent to any existing balance plus total charges from this billing period. e.g. if you have an unpaid balance of $50 from last billing period and your total charges for this billing period is $100, then total_amount_due = 150.
    - `total_charges` number — Total charges for energy usage during this billing period.
    - `charges` object
      - `electric_charges` number — Total electric charges from Utility. Equal to delivery + generation charges if the Utility is responsible for generating electricity for this Account. Equal to just delivery charges if a separate company handles electricity generation.
      - `supplier_electric_charges` number — Electricity generation charges from supplier. Null if Utility is supplier.
      - `gas_charges` number
      - `other_charges` number
    - `electric_usage_kwh` number
    - `gas_usage_therm` number

## Other responses

- `400` — Client error
- `401` — Unauthorized
- `402` — Quota reached
- `403` — Permission denied
- `500` — Server error

---

[API](https://skmtc.net/pelm/apis/pelm-api.md) · [All operations](https://skmtc.net/pelm/apis/pelm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pelm/pelm-api/revisions/99451cd0e777/schema)