---
title: "Get Address Endpoints for a Domain"
method: GET
path: "/domains/{domain}/addresses/endpoints"
tags: ["Addresses"]
---

# Get Address Endpoints for a Domain

`GET /domains/{domain}/addresses/endpoints`

Emergency Address Endpoints are different than Emergency Addresses. Endpoints contain the Emergency Caller ID Number and the address associated with it should be the billing address. Emergency Addresses are what is passed in to the PIDFLO object.

## Path parameters

- `domain` string, required — This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.

## Query parameters

- `limit` number — This is the limit of the number of objects that will be returned in the read/list API call. This can be used with pagination to help retrieve smaller chunks of data. Should be used in conjunction with Start.

## Response `200`

- Address[]
  - `emergency-address-id` string, required — This is an autogenerated ID for the Address.
  - `domain` string, required — This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. ~ and * can be used alone in special cases to mean My Domain (~) and All Domains (\*).
  - `user` string, required — This is the main user extension for the user account.
  - `address-name` string, required — This is the name label for the address
  - `caller-name` string, required — This is the caller's name for the address
  - `address-line-1` string, required — This is the address line 1 for the address
  - `address-line-2` string, nullable — This is the address line 2 for the address
  - `address-city` string, required — This is the city for the address
  - `address-state-province-abbreviation` string, required — This is the state or province (Canadian) abbreviation for the address
  - `address-postal-code` string, required — This is the postal code for the address
  - `address-country-abbreviation` string, required — This is the country appreviation for the address
  - `address-location-description` string, nullable — This is an optional location description for the address
  - `ip-address-public` string, nullable — This is the public IP of the client window creating the address.
  - `address-formatted-pidflo` string, required — This is a return value of the formatted PIDFLO standardized value for the address
  - `carrier` string, nullable — This is the carrier name for the address
  - `count-users-configured` integer, nullable — This is the count of how many users are using the particular address
  - `address-formatted-pretty` string, nullable — This is a human readable format of the address
  - `address-is-default-for-site` boolean, nullable — This is whether the address is a default for the site

## Other responses

- `400`
- `401`
- `404`

---

[API](https://skmtc.net/ns-api/apis/netsapiens-api-v2.md) · [All operations](https://skmtc.net/ns-api/apis/netsapiens-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ns-api/netsapiens-api-v2/versions/d37f65b5b886/schema)