---
title: "Retrieve a list of address configurations for an account"
method: GET
path: "/v1/Configuration/Addresses"
tags: ["ConversationsV1AddressConfiguration"]
---

# Retrieve a list of address configurations for an account

`GET /v1/Configuration/Addresses`

Retrieve a list of address configurations for an account

## Query parameters

- `Type` string
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `address_configurations` ConversationsV1ConfigurationAddress[]
    - `sid` string, nullable — A 34 character string that uniquely identifies this resource.
    - `account_sid` string, nullable — The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) the address belongs to
    - `type` string, nullable — Type of Address, value can be `whatsapp` or `sms`.
    - `address` string, nullable — The unique address to be configured. The address can be a whatsapp address or phone number
    - `friendly_name` string, nullable — The human-readable name of this configuration, limited to 256 characters. Optional.
    - `auto_creation` unknown
    - `date_created` string, date-time, nullable — The date that this resource was created.
    - `date_updated` string, date-time, nullable — The date that this resource was last updated.
    - `url` string, uri, nullable — An absolute API resource URL for this address configuration.
    - `address_country` string, nullable — An ISO 3166-1 alpha-2n country code which the address belongs to. This is currently only applicable to short code addresses.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2025-07-03** (v1) `92d1169c37c2` — 1 breaking
  - the `address_configurations/items/auto_creation` response's property type/format changed from `object`/`` to ``/`` for status `200`
- **2025-06-12** (v1) `9e5a9439b5b3` — 1 breaking
  - for the `query` request parameter `PageSize`, the max was decreased from `1000.00` to `50.00`
- **2025-03-11** (v1) `b4d0e634cd69` — 1 breaking
  - the `address_configurations/items/auto_creation` response's property type/format changed from ``/`` to `object`/`` for status `200`
- **2025-02-20** (v1) `2cf60eb95eb9` — 1 breaking
  - for the `query` request parameter `PageSize`, the type/format was changed from `integer`/`` to `integer`/`int64`
- **2023-08-10** (v1) `4e3f150aaa78` — 1 info
  - api tag `ConversationsV1AddressConfiguration` added

[Full history](https://skmtc.dev/twilio/apis/conversations-v1/changes/v1/Configuration/Addresses/get.md)

---

[API](https://skmtc.dev/twilio/apis/conversations-v1.md) · [All operations](https://skmtc.dev/twilio/apis/conversations-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/conversations-v1/revisions/6a37056c7727/schema)