---
title: "Retrieve an Address by ID"
method: GET
path: "/v1/addresses/{addressId}"
tags: ["address"]
---

# Retrieve an Address by ID

`GET /v1/addresses/{addressId}`

Get address info by ID.

## Path parameters

- `addressId` integer, required

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

OK - Successfully retrieved the address.

- Address — Represents a physical address associated with a profile.
  - `id` integer — Address ID.
  - `profile` integer — User profile ID.
  - `details` object — Address details.
    - `country` string — Country code (ISO 3166-2 Country Code).
    - `firstLine` string — Address line: street, house, apartment.
    - `postCode` string — Postal or zip code (max 30 characters).
    - `city` string — City name.
    - `state` string — State code. Required if country is US, CA, BR, or AU.
    - `occupations` object[] — User occupations. Required for CA, IN, JP, ID, IL, MX, and within the US for state NM.
      - `code` string — User occupation - any value permitted.
      - `format` 'FREE_FORM' — Occupation type - always `FREE_FORM`.

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

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