---
title: "Retrieve a user address"
method: GET
path: "/user/addresses/{id}"
tags: ["UserAddresses"]
---

# Retrieve a user address

`GET /user/addresses/{id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/user/addresses/{id}`
- Auth: HTTP bearer

Retrieves the details of an existing user address.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- object
  - `data` UserAddress
    - `id` string, uuid: Uniquely identifies the user address.
    - `record_type` string: Identifies the type of the resource.
    - `customer_reference` string: A customer reference string for customer look ups.
    - `first_name` string: The first name associated with the user address.
    - `last_name` string: The last name associated with the user address.
    - `business_name` string: The business name associated with the user address.
    - `phone_number` string: The phone number associated with the user address.
    - `street_address` string: The primary street address information about the user address.
    - `extended_address` string: Additional street address information about the user address such as, but not limited to, unit number or apartment number.
    - `locality` string: The locality of the user address. For US addresses, this corresponds to the city of the address.
    - `administrative_area` string: The locality of the user address. For US addresses, this corresponds to the state of the address.
    - `neighborhood` string: The neighborhood of the user address. This field is not used for addresses in the US but is used for some international addresses.
    - `borough` string: The borough of the user address. This field is not used for addresses in the US but is used for some international addresses.
    - `postal_code` string: The postal code of the user address.
    - `country_code` string: The two-character (ISO 3166-1 alpha-2) country code of the user address.
    - `created_at` string: ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string: ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `401`: Unauthorized
- `404`: Resource not found
- `422`: Bad request

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/user/addresses/:id/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)
