---
title: "Update a billing address"
method: PATCH
path: "/v3/billing/addresses/{id}"
tags: ["BillingAddresses"]
---

# Update a billing address

`PATCH /v3/billing/addresses/{id}`

Update the billing address.

## Path parameters

- `id` string, required

## Request body

- BillingAddressRequestModel
  - `firstLine` string, required
  - `secondLine` string, nullable
  - `city` string, required
  - `postalCode` string, required
  - `region` string, required
  - `countryCode` string, required
  - `name` string, required — Any printable characters, including letters from any script, punctuation and emoji. Cannot contain line breaks, tabs, other control characters, invisible formatting characters (zero-width and bidirectional marks), and cannot start or end with whitespace.
  - `taxIdentifier` string, nullable
  - `contacts` PaddleBusinessContactDto[], required
    - `name` string, nullable
    - `email` string, required

## Response `200`

OK

- BillingAddressDto
  - `id` string, required
  - `firstLine` string, required
  - `secondLine` string, required
  - `city` string, required
  - `postalCode` string, required
  - `region` string, required
  - `countryCode` string, required
  - `name` string, required
  - `taxIdentifier` string, required
  - `contacts` PaddleBusinessContactDto[], required
    - `name` string, nullable
    - `email` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Server Error

## Changes

- **2026-08-18** `66dcb6293180` — 1 breaking
  - added the pattern `^(?!\s)(?!.*\s$)[^\p{Cc}\p{Cf}\p{Zl}\p{Zp}]+$` to the request property `name`

[Change history](https://skmtc.dev/cryptlex/apis/cryptlex-web-api/changes/v3/billing/addresses/:id/patch.md)

---

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