---
title: "Update the account holder's current address"
method: POST
path: "/api/v2/addresses"
tags: ["Addresses"]
---

# Update the account holder's current address

`POST /api/v2/addresses`

## Request

- Base URL: `https://api.starlingbank.com`
- URL: `https://api.starlingbank.com/api/v2/addresses`
- Auth: HTTP bearerandsignature
- TypeScript: <https://skmtc.dev/starlingbank/apis/starling-bank-api/docs/api/v2/addresses/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- AddressUpdateRequest: Address update request
  - `line1` string, required
  - `line2` string
  - `line3` string
  - `postTown` string, required
  - `postCode` string, required
  - `countryCode` string, required: Country code in ISO 3166-1 alpha-2. NB GB is the official country code for the UK. UK is not the officially assigned code, and so is not valid
  - `udprn` string: The UDPRN of the property
  - `umprn` string: The UMPRN of the property
  - `from` string, date, required: Date the account holder's residency at this address started

## Response `200`

Successful operation

## Other responses

- `4xx`: Client error. See [API status codes](#api-status-codes-1) for more details.
- `5xx`: Server error. See [API status codes](#api-status-codes-1) for more details.

---

[API](https://skmtc.dev/starlingbank/apis/starling-bank-api.md) - [All operations](https://skmtc.dev/starlingbank/apis/starling-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlingbank/apis/starling-bank-api/revisions/7c5075cfbe63?raw)