---
title: "Retrieve address details"
method: POST
path: "/user/addresses/lookup/retrieve"
tags: ["user-addresses"]
---

# Retrieve address details

`POST /user/addresses/lookup/retrieve`

Retrieve full structured address fields for a selected lookup result.

Use this endpoint as step 2 of the assisted lookup workflow, after POST /user/addresses/lookup/find.

How to use this endpoint:

1. Call POST /user/addresses/lookup/find and let the user choose a specific address result.
2. Send that result id to this endpoint.
3. Use the returned structured fields to prefill or confirm the address form.
4. Save the confirmed address with POST /user/addresses.

Behavior notes:

- This endpoint resolves data only; it does not create or update a saved address.
- The returned payload is intended to reduce manual entry errors and improve consistency.
- If the supplied id is invalid or unavailable, the request fails and the client should return to lookup.

## Request body

- object
  - `id` string, required — The ID of a specific address to retrieve

## Response `200`

Retrieve a specific address

- object
  - `id` string — Unique identifier for the address
  - `department` string — Department or internal division
  - `company` string — Company name associated with the address
  - `subBuilding` string — Sub-building identifier (e.g., Apartment or Suite number)
  - `buildingNumber` string — Building number in the street
  - `buildingName` string — Name of the building
  - `secondaryStreet` string — Secondary street address, if any
  - `street` string — Primary street name
  - `block` string — Block name or number
  - `neighbourhood` string — Neighbourhood or locality
  - `district` string — District or borough
  - `city` string — City or town
  - `line1` string — First line of the formatted address
  - `line2` string — Second line of the formatted address
  - `line3` string — Third line of the formatted address
  - `line4` string — Fourth line of the formatted address
  - `line5` string — Fifth line of the formatted address
  - `adminArea` string — Administrative area name (e.g., county or region)
  - `adminAreaCode` string — Administrative area code
  - `state` string — State or province name
  - `stateCode` string — State or province code
  - `postalCode` string — Postal or ZIP code
  - `country` string — Full country name
  - `countryIso2` string — ISO 3166-1 alpha-2 country code
  - `countryIso3` string — ISO 3166-1 alpha-3 country code
  - `countryIsoNumber` string, nullable — ISO 3166-1 numeric country code
  - `sortingNumber1` string — Primary sorting number (used in mail sorting)
  - `sortingNumber2` string — Secondary sorting number (used in mail sorting)
  - `barcode` string — Postal barcode for mail sorting
  - `poBoxNumber` string — Post Office Box number
  - `label` string — Formatted label for display
  - `type` string — Type of address (e.g., Residential, Business, etc.)

---

[API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/6367b514f6ea/schema)
