---
title: "List E911 addresses"
method: GET
path: "/api/relay/rest/addresses"
tags: ["E911 Addresses"]
---

# List E911 addresses

`GET /api/relay/rest/addresses`

Returns a list of your Addresses. The addresses are returned sorted by creation date, with the most recent appearing first.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Query parameters

- `filter_label` string
- `page_number` integer
- `page_size` integer
- `page_token` string

## Response `200`

The request has succeeded.

- AddressListResponse — Response containing a list of addresses.
  - `links` PaginationLinks, required — Pagination links for list responses.
    - `self` string, required — Link to the current page.
    - `first` string, required — Link to the first page.
    - `next` string — Link to the next page. Only present when there are more results.
    - `prev` string — Link to the previous page. Only present when not on the first page.
  - `data` Address[], required — List of addresses.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `label` string, required — A friendly name given to the address to help distinguish and search for different addresses within your project.
    - `country` string, required — The ISO 3166 Alpha 2 country code.
    - `first_name` string, required — First name of the occupant associated with this address.
    - `last_name` string, required — Last name of the occupant associated with this address.
    - `street_number` string, required — The number portion of the street address.
    - `street_name` string, required — The name portion of the street address.
    - `address_type` 'Apartment' | 'Basement' | 'Building' | 'Department' | 'Floor' | 'Office' | 'Penthouse' | 'Suite' | 'Trailer' | 'Unit', required — Address type for sub-addresses.
    - `address_number` string, nullable, required — If the address is divided into multiple sub-addresses, this identifies the particular sub-address.
    - `city` string, required — The city portion of the street address.
    - `state` string, required — The state/province/region of the street address. In the USA and Canada, use the two-letter abbreviated form.
    - `postal_code` string, required — The postal code of the street address.
    - `zip_code` string, required — The postal code of the street address. Alias for postal_code for backwards compatibility.
    - `emergency_enabled` boolean, required — Whether E911 emergency calling is enabled for this address (carrier-validated when created/updated with `emergency_enabled=true` for a US address).
    - `validated` boolean, required — Whether the address was validated by the carrier (true when the carrier returned a valid or auto-corrected match).
    - `validated_at` string, nullable, required — The RFC 3339 / ISO 8601 timestamp of the last successful carrier validation, or null if never validated.

## Other responses

- `401` — Access is unauthorized.
- `422` — The request failed validation. See errors for details.
- `500` — An internal server error occurred.

---

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