---
title: "Update LOA status"
method: PUT
path: "/v1/loas/{loaId}/status"
tags: ["LOA Management"]
---

# Update LOA status

`PUT /v1/loas/{loaId}/status`

Update the status of an LOA. Valid statuses: PENDING, SENT, SIGNED, EXPIRED, REJECTED.

## Path parameters

- `loaId` string, required

## Request body

- object
  - `status` 'PENDING' | 'SENT' | 'SIGNED' | 'EXPIRED' | 'REJECTED', required — New status for the LOA

## Response `200`

LOA status updated successfully

- LOA
  - `id` string — LOA identifier
  - `businessId` string — Associated business identifier
  - `customerName` string — Customer/business name
  - `customerAddress` string — Customer address
  - `status` 'PENDING' | 'SENT' | 'SIGNED' | 'EXPIRED' | 'REJECTED' — LOA status
  - `filePath` string — Path to stored LOA document
  - `authorizedPersons` object[]
    - `id` string
    - `name` string
    - `company` string
    - `role` string
  - `supplyPoints` object[]
    - `id` string
    - `mpanMprn` string
    - `supplyType` 'electricity' | 'gas'
    - `address` string
    - `meterId` string — Linked meter ID if found
  - `validFrom` string, date
  - `validTo` string, date
  - `signatureDate` string, date
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

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