Read domain address

GET

/domains/{domain}/addresses/{emergency-address-id}

Last modified:2026-10-06 19:38:10

OperationId:GetAddressForDomain

Returns one emergency (E911) address in a domain, addressed by its emergency-address-id, with address-formatted-pretty added. It can be a domain-level, site, or personal address.

Requires Office Manager or Site Manager scope for your own domain, Reseller scope for the domains in your territory, or Super User scope. Site Manager scope is not limited to its own site here: it reaches every address in the domain. Super User Read Only scope can read.

Returns 404 when the domain does not exist or has no address with this ID. To read the addresses that apply to one user, use GET /domains/{domain}/users/{user}/addresses.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200OK

application/json

The address.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains/example.com/addresses/a-6525c1ae9d7ff' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Domain-level address

{
    "emergency-address-id": "a-6525c1ae9d7ff",
    "domain": "example.com",
    "user": "*",
    "address-name": "Main Office",
    "caller-name": "Front Desk",
    "address-line-1": "123 Example St",
    "address-line-2": "Suite 100",
    "address-city": "Example City",
    "address-state-province-abbreviation": "CA",
    "address-postal-code": "90210",
    "address-country-abbreviation": "US",
    "address-location-description": "Front desk",
    "ip-address-public": "203.0.113.30",
    "address-formatted-pidflo": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><presence xmlns=\"urn:ietf:params:xml:ns:pidf\" xmlns:gp=\"urn:ietf:params:xml:ns:pidf:geopriv10\" xmlns:gbp=\"urn:ietf:params:xml:ns:pidf:geopriv10:basicPolicy\" xmlns:ca=\"urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr\" xmlns:gml=\"http://www.opengis.net/gml\" xmlns:dm=\"urn:ietf:params:xml:ns:pidf:data-model\" entity=\"pres:9zdRwdQqYV88tX@123.123.123.123\"><dm:device id=\"target123-1\"><gp:geopriv><gp:location-info><ca:civicAddress><ca:country>US</ca:country><ca:HNO>123</ca:HNO><ca:RD>EXAMPLE</ca:RD><ca:STS>ST</ca:STS><ca:A1>CA</ca:A1><ca:A3>EXAMPLE CITY</ca:A3><ca:LOC>Suite 100 Front desk</ca:LOC><ca:PC>90210-1234</ca:PC></ca:civicAddress></gp:location-info></gp:geopriv></dm:device></presence>",
    "carrier": "bandwidth",
    "address-formatted-pretty": "123 Example St\r\nSuite 100 Front desk\r\nExample City, CA 90210, US"
}

Modified at 2026-10-06 19:38:10

List user contacts (reduced)

Read address endpoint