---
title: "Gets all additional addresses of a customer"
method: GET
path: "/core/latest/customers/{customer-id}/additional-addresses"
tags: ["Customer"]
---

# Gets all additional addresses of a customer

`GET /core/latest/customers/{customer-id}/additional-addresses`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/core/latest/customers/{customer-id}/additional-addresses`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

## Path parameters

- `customer-id` string, required

## Response `200`

List of all additional addresses

- Address[]
  - `id` string: Id of this Address. Does not need to be included when creating customer
  - `validFrom` string, date: The timestamp from which this address is valid
  - `validTo` string, date: The timestamp to which this address is valid
  - `addressLines` string, required: The address lines for this Address
  - `addressType` string, required: The type of address, could be [PRIVATE, WORK, SHIPPING]. For company, address type <strong>MUST</strong> be <strong>PRIVATE</strong>.
  - `cityName` string, required: Name of this City
  - `cityZipCode` string: The postal code of the city for this address. <strong>Required for Switzerland addresses</strong> (countryIso2Code = CH), where it is matched against the KLARA city register together with cityName; a missing or non-matching combination is rejected with 400. Ignored for every other country, where cityName is taken as given. Conditional on another field, so it is not marked required.
  - `countryIso2Code` string, required: 2 letter country code. For company, only accept Switzerland
  - `countryIso3Code` string: 3 letter country code. For company, only accept Switzerland
  - `countryNumericCode` string: ISO-numeric code. For company, only accept Switzerland
  - `city_href` string: The path to get City object by city's id, /cities/{}
  - `definitionName` string: definition name of this address; in case main address, value is null; else value is not blank
  - `additionalAddress` string: Additional address for more specific

## Other responses

- `401`: No Authorization header found or invalid token<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `403`: The current user is not allowed to access this company data<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `404`: Resource not found<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `429`: API rate limit exceeded<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.

---

[API](https://skmtc.dev/klara/apis/klara-public-api.md) · [All operations](https://skmtc.dev/klara/apis/klara-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klara/apis/klara-public-api/revisions/490b1a879fc2?raw)