---
title: "List all addresses"
method: GET
path: "/addresses"
tags: ["Addresses"]
---

# List all addresses

`GET /addresses`

Returns a list of your addresses.

## Query parameters

- `page` object
  - `number` integer — The page number to load
  - `size` integer — The size of the page
- `filter` object
  - `address_book` object
    - `eq` string — If present, only returns results with the <code>address_book</code> flag equal to the given value.
  - `customer_reference` union
    - string — If present, addresses with <code>customer_reference</code> containing the given value will be returned. Matching is not case-sensitive.
    - object
      - `contains` string — Partial match for customer_reference. Matching is not case-sensitive.
      - `eq` string — Exact match for customer_reference.
  - `street_address` object
    - `contains` string — If present, addresses with <code>street_address</code> containing the given value will be returned. Matching is not case-sensitive. Requires at least three characters.
  - `used_as_emergency` string — If set as 'true', only addresses used as the emergency address for at least one active phone-number will be returned. When set to 'false', the opposite happens: only addresses not used as the emergency address from phone-numbers will be returned.
- `sort` 'created_at' | 'first_name' | 'last_name' | 'business_name' | 'street_address'

## Response `200`

Successful response

- object
  - `data` Address[]
    - `address_book` boolean — Indicates whether or not the address should be considered part of your list of addresses that appear for regular use.
    - `administrative_area` string — The locality of the address. For US addresses, this corresponds to the state of the address.
    - `borough` string — The borough of the address. This field is not used for addresses in the US but is used for some international addresses.
    - `business_name` string — The business name associated with the address. An address must have either a first last name or a business name.
    - `country_code` string — The two-character (ISO 3166-1 alpha-2) country code of the address.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `customer_reference` string — A customer reference string for customer look ups.
    - `extended_address` string — Additional street address information about the address such as, but not limited to, unit number or apartment number.
    - `first_name` string — The first name associated with the address. An address must have either a first last name or a business name.
    - `id` string — Uniquely identifies the address.
    - `last_name` string — The last name associated with the address. An address must have either a first last name or a business name.
    - `locality` string — The locality of the address. For US addresses, this corresponds to the city of the address.
    - `neighborhood` string — The neighborhood of the address. This field is not used for addresses in the US but is used for some international addresses.
    - `phone_number` string — The phone number associated with the address.
    - `postal_code` string — The postal code of the address.
    - `record_type` string — Identifies the type of the resource.
    - `street_address` string — The primary street address information about the address.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.
    - `validate_address` boolean — Indicates whether or not the address should be validated for emergency use upon creation or not. This should be left with the default value of `true` unless you have used the `/addresses/actions/validate` endpoint to validate the address separately prior to creation. If an address is not validated for emergency use upon creation and it is not valid, it will not be able to be used for emergency services.
  - `meta` PaginationMeta
    - `page_number` integer
    - `page_size` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)