---
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

---

[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)