---
title: "View address"
method: GET
path: "/api/v2/customers/{customerId}/addresses/{id}"
tags: ["Customer Address"]
---

# View address

`GET /api/v2/customers/{customerId}/addresses/{id}`

Returns details of a single customer address

## Path parameters

- `customerId` string, required — Resource identifier.
- `id` union, required
  - 'masterdata' | 'billingaddress'
  - string — Resource identifier.

## Response `200`

Customer address response object

- object
  - `data` object, required — Customer Address object
    - `id` string, required — Resource identifier.
    - `type` 'masterdata' | 'billingaddress' | 'deliveryaddress', required — Type of customer address
    - `name` string, nullable, required — Full name of the customer
    - `street` string, nullable, required — Street name and house number
    - `addressSupplement` string, nullable, required — Additional address information, such as floor or unit
    - `zip` string, nullable, required — Postal code for the address
    - `city` string, nullable, required — City of the address
    - `country` string, nullable, required — Country code in ISO 3166-1 alpha-2 format
    - `state` string, nullable, required — State or region code in ISO format, if applicable
    - `department` string, nullable, required — Department of customer if necessary and available
    - `subDepartment` string, nullable, required — Sub-Department of customer if necessary and available
    - `contactDetails` object, required — Contact information of a customer
      - `phone` string, nullable — Phone number of a customer
      - `email` string, nullable — Email address of a customer
      - `gln` string, nullable — Global Location Number (GLN) of the company
    - `deliveryDetails` object, nullable — Details about the customer's delivery address
      - `defaultDeliveryAddress` boolean — Indicates whether this is the default delivery address. Only one delivery address can be set as default.
      - `termsOfDelivery` string, nullable — Terms of delivery associated with this address
      - `vatId` string, nullable — VAT ID associated with the delivery address. Can be empty.
      - `taxType` 'domestic' | 'eu-delivery' | 'export' | 'free', nullable — Tax type associated with the delivery address. Can be one of: domestic, eu-delivery, export, free.
      - `internalComment` string, nullable — Internal comment about the delivery address
      - `note` string, nullable — Additional note regarding the delivery address
  - `links` object — A collection of related links for the customer resource.
    - `self` string — A URL linking directly to this specific customer address resource.
    - `customer` string — A URL linking to the customer resource associated with this address.

## Other responses

- `400` — IETF RFC 9457 Problem API compliant response
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `404` — Resource was not found or not enough access privileges
- `406` — Requested resource representation does not exist.
- `429` — Too many API calls made.

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)