---
title: "Parse LOA (Preview)"
method: POST
path: "/v1/loas/parse"
tags: ["LOA Management"]
---

# Parse LOA (Preview)

`POST /v1/loas/parse`

Parse a Letter of Authority document without saving. Use this to preview extracted data before committing. Returns customer info, authorized persons, supply points (MPANs/MPRNs), and validity period.

## Response `200`

LOA parsed successfully

- ParsedLOA
  - `customerName` string — Customer/business name
  - `customerAddress` string — Customer address
  - `authorizedPersons` object[]
    - `name` string — Name of authorized person
    - `company` string — Company name
    - `role` string — Role/position
  - `supplyPoints` object[]
    - `mpanMprn` string — MPAN or MPRN
    - `supplyType` 'electricity' | 'gas'
    - `address` string — Supply point address
  - `validFrom` string, date — LOA validity start date
  - `validTo` string, date — LOA validity end date
  - `signatureDate` string, date — Date of signature

## Other responses

- `4XX` — Client error response

## Changes

- **2025-12-02** `341d0d8f51f9` — 1 info
  - endpoint added
- **2025-11-17** `1ecbbc9bbafb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/voltview/apis/voltview-api/changes/v1/loas/parse/post.md)

---

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