---
title: "Invoices for all sites"
method: GET
path: "/v1/sites/invoices"
tags: ["Sites"]
---

# Invoices for all sites

`GET /v1/sites/invoices`

Retrieves invoice information across all sites

## Response `200`

Invoice information retrieved successfully

- Invoice[]
  - `documentType` 'invoice' | 'statement' | 'credit_note' | 'debit_note', nullable — Type of document
  - `isStatement` boolean, nullable — Whether this document is a statement
  - `supplierName` string, nullable — Name of the supplier
  - `supplierAccountNumber` string, nullable — Supplier account number
  - `customerName` string, nullable — Name of the customer
  - `billingAddress` string, nullable — Billing address
  - `items` object[], nullable — Invoice line items
    - `itemType` 'invoice' | 'credit' | 'debit', nullable — Type of item
    - `invoiceNumber` string, nullable — Invoice number
    - `invoiceDate` string, date, nullable — Invoice date (YYYY-MM-DD)
    - `dueDate` string, date, nullable — Due date (YYYY-MM-DD)
    - `chargeStartDate` string, date, nullable — Charge period start date (YYYY-MM-DD)
    - `chargeEndDate` string, date, nullable — Charge period end date (YYYY-MM-DD)
    - `netAmount` number, nullable — Net amount before VAT
    - `vatAmount` number, nullable — VAT amount
    - `totalAmount` number, nullable — Total amount including VAT
    - `previousBalance` number, nullable — Balance on last bill
    - `outstandingBalance` number, nullable — Outstanding balance
    - `supplyPoints` object[], nullable — Supply points associated with this item
      - `mpanMprn` string, nullable — MPAN (13 digits for electricity) or MPRN (6-10 digits for gas)
      - `supplyType` 'electricity' | 'gas', nullable — Type of supply
      - `meterSerialNumber` string, nullable — Meter serial number
      - `consumption` object, nullable — Consumption details
        - `total` number, nullable — Total consumption
        - `unit` string — Unit of consumption
      - `charges` object[], nullable — Charges for this supply point
        - `category` 'energy' | 'standing' | 'distribution' | 'transmission' | 'environmental' | 'capacity' | 'metering' | 'adjustment' | 'other', nullable — Charge category
        - `description` string, nullable — Charge description
        - `chargeStartDate` string, date, nullable — Charge start date (YYYY-MM-DD)
        - `chargeEndDate` string, date, nullable — Charge end date (YYYY-MM-DD)
        - `startReading` number, nullable — Start meter reading
        - `endReading` number, nullable — End meter reading
        - `readingType` 'actual' | 'estimated', nullable — Type of reading
        - `quantity` number, nullable — Quantity
        - `unit` string, nullable — Unit of quantity
        - `rate` number, nullable — Rate
        - `rateUnit` string, nullable — Rate unit (e.g., p/kWh, p/day, p/kVA/day)
        - `vatRate` number, nullable — VAT rate percentage
        - `netAmount` number, nullable — Net amount before VAT
        - `totalAmount` number, nullable — Total amount including VAT
      - `meterReadings` object[], nullable — Meter readings for this supply point
        - `date` string, date, nullable — Reading date (YYYY-MM-DD)
        - `type` 'actual' | 'estimated', nullable — Type of reading
        - `reading` string, nullable — Meter reading value
        - `unit` string, nullable — Unit of reading (e.g., kWh)
        - `register` 'day' | 'night' | 'peak' | 'off_peak' | 'other', nullable — Register type

## Other responses

- `4XX` — Client error response

---

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