---
title: "Parse invoice"
method: POST
path: "/v1/billValidation/parseInvoice"
tags: ["Bill Validation", "Invoice Parsing"]
---

# Parse invoice

`POST /v1/billValidation/parseInvoice`

Uploads and processes a UK energy supplier invoice (PDF or images) to extract invoice details, supply points (MPANs/MPRNs), and associated consumption and charge information.

## Response `200`

Invoice successfully parsed

- object
  - `success` boolean
  - `data` ExtractedData
    - `documentType` 'invoice' | 'statement' | 'credit_note' | 'debit_note', nullable — Type of document
    - `isStatement` boolean, nullable — Whether the 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 — Array of invoice items
      - `itemType` 'invoice' | 'credit' | 'debit', nullable — Type of invoice 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

- `400` — Bad request - Invalid input
- `401` — Unauthorized - Authentication required
- `500` — Server error
- `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)