Get Emergency Calling Service#

Returns a single Emergency Calling Service owned by your account.

Request#

HTTP Method: GET

URI Path: /v3/emergency_calling_services/{id}

Note

For all returned data attributes, see Emergency Calling Service Object.

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique ID identifier of the emergency calling service.

include

string

No

Related resources to include in the response. See Inclusion.

fields[emergency_calling_services]

string

No

Sparse fieldsets

Includes#

Value

Description

country

Country Object

order

Order Object

emergency_requirement

Emergency Requirement Object

emergency_verification

Emergency Verification Object

dids

DID Object

Examples#

http

1GET /v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890 HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]

curl

1curl -i -X GET https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890 -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"

response

 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5    "data": {
 6        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
 7        "type": "emergency_calling_services",
 8        "attributes": {
 9            "number_type": "local",
10            "name": "E911 Service - New York Office",
11            "reference": "SHB-485120",
12            "status": "active",
13            "activated_at": "2026-01-15T10:30:00.000Z",
14            "canceled_at": null,
15            "renew_date": "2026-07-15",
16            "created_at": "2026-01-10T08:00:00.000Z"
17        },
18        "relationships": {
19            "country": {
20                "links": {
21                    "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/country",
22                    "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/country"
23                }
24            },
25            "order": {
26                "links": {
27                    "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/order",
28                    "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/order"
29                }
30            },
31            "emergency_requirement": {
32                "links": {
33                    "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_requirement",
34                    "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_requirement"
35                }
36            },
37            "emergency_verification": {
38                "links": {
39                    "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_verification",
40                    "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_verification"
41                }
42            },
43            "dids": {
44                "links": {
45                    "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/dids",
46                    "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/dids"
47                }
48            }
49        },
50        "meta": {
51            "setup_price": "0.0",
52            "monthly_price": "2.5"
53        }
54    },
55    "meta": {
56        "api_version": "2026-11-19"
57    }
58}

Other Responses#

Code

Success

Description

401

No

Unauthorized

403

No

Forbidden. Emergency calling is not enabled for the account.

404

No

Not Found

429

No

The request budget of the account for the current window is spent (too_many_requests). Retry-After gives the number of seconds to wait.