Get Emergency Calling Services#
Returns the list of emergency calling services.
Request#
HTTP Method: GET
URI Path: /v3/emergency_calling_services
Note
For all returned data attributes, see Emergency Calling Service Object.
URI Query Parameters#
Name |
Type |
Is Required? |
Description |
|---|---|---|---|
include |
|
No |
|
filter[<filter_name>] |
|
No |
|
fields[emergency_calling_services] |
|
No |
|
sort |
|
No |
|
page[number] |
|
No |
|
page[size] |
|
No |
Page size. Pagination defaults to |
Includes#
Value |
Description |
|---|---|
country |
|
order |
|
emergency_requirement |
|
emergency_verification |
|
dids |
Filters#
Filter Name |
Type |
Allow Blank |
Allow Array |
Filters by: |
|---|---|---|---|---|
id |
|
No |
Yes |
The |
status |
|
No |
No |
The |
country.id |
|
No |
Yes |
The |
number_type |
|
No |
Yes |
The |
address.id |
|
No |
No |
The |
identity.id |
|
No |
No |
The |
name |
|
No |
No |
The |
reference |
|
No |
No |
The |
Sorting#
Value |
Sorts by: |
|---|---|
name |
The |
status |
The |
country.name |
The related country name. |
renew_date |
The |
created_at |
The |
Examples#
http
1GET /v3/emergency_calling_services 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 -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 {
7 "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
8 "type": "emergency_calling_services",
9 "attributes": {
10 "number_type": "local",
11 "name": "E911 Service - New York Office",
12 "reference": "SHB-485120",
13 "status": "active",
14 "activated_at": "2026-01-15T10:30:00.000Z",
15 "canceled_at": null,
16 "renew_date": "2026-07-15",
17 "created_at": "2026-01-10T08:00:00.000Z"
18 },
19 "relationships": {
20 "country": {
21 "links": {
22 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/country",
23 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/country"
24 }
25 },
26 "order": {
27 "links": {
28 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/order",
29 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/order"
30 }
31 },
32 "emergency_requirement": {
33 "links": {
34 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_requirement",
35 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_requirement"
36 }
37 },
38 "emergency_verification": {
39 "links": {
40 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_verification",
41 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_verification"
42 }
43 },
44 "dids": {
45 "links": {
46 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/dids",
47 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/dids"
48 }
49 }
50 },
51 "meta": {
52 "setup_price": "0.0",
53 "monthly_price": "2.5"
54 }
55 }
56 ],
57 "meta": {
58 "total_records": 1,
59 "api_version": "2026-11-19"
60 },
61 "links": {
62 "first": "https://api.didww.com/v3/emergency_calling_services?page%5Bnumber%5D=1&page%5Bsize%5D=50",
63 "last": "https://api.didww.com/v3/emergency_calling_services?page%5Bnumber%5D=1&page%5Bsize%5D=50"
64 }
65}
http
1GET /v3/emergency_calling_services?filter%5Bstatus%5D=active 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?filter%5Bstatus%5D=active' -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 {
7 "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
8 "type": "emergency_calling_services",
9 "attributes": {
10 "number_type": "local",
11 "name": "E911 Service - New York Office",
12 "reference": "SHB-485120",
13 "status": "active",
14 "activated_at": "2026-01-15T10:30:00.000Z",
15 "canceled_at": null,
16 "renew_date": "2026-07-15",
17 "created_at": "2026-01-10T08:00:00.000Z"
18 },
19 "relationships": {
20 "country": {
21 "links": {
22 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/country",
23 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/country"
24 }
25 },
26 "order": {
27 "links": {
28 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/order",
29 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/order"
30 }
31 },
32 "emergency_requirement": {
33 "links": {
34 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_requirement",
35 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_requirement"
36 }
37 },
38 "emergency_verification": {
39 "links": {
40 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_verification",
41 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_verification"
42 }
43 },
44 "dids": {
45 "links": {
46 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/dids",
47 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/dids"
48 }
49 }
50 },
51 "meta": {
52 "setup_price": "0.0",
53 "monthly_price": "2.5"
54 }
55 }
56 ],
57 "meta": {
58 "total_records": 1,
59 "api_version": "2026-11-19"
60 },
61 "links": {
62 "first": "https://api.didww.com/v3/emergency_calling_services?filter%5Bstatus%5D=active&page%5Bnumber%5D=1&page%5Bsize%5D=50",
63 "last": "https://api.didww.com/v3/emergency_calling_services?filter%5Bstatus%5D=active&page%5Bnumber%5D=1&page%5Bsize%5D=50"
64 }
65}
http
1GET /v3/emergency_calling_services?filter%5Bcountry.id%5D=72f22218-ab1f-4933-a74d-a6467f3f6cb0 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?filter%5Bcountry.id%5D=72f22218-ab1f-4933-a74d-a6467f3f6cb0' -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 {
7 "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
8 "type": "emergency_calling_services",
9 "attributes": {
10 "number_type": "local",
11 "name": "E911 Service - New York Office",
12 "reference": "SHB-485120",
13 "status": "active",
14 "activated_at": "2026-01-15T10:30:00.000Z",
15 "canceled_at": null,
16 "renew_date": "2026-07-15",
17 "created_at": "2026-01-10T08:00:00.000Z"
18 },
19 "relationships": {
20 "country": {
21 "links": {
22 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/country",
23 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/country"
24 }
25 },
26 "order": {
27 "links": {
28 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/order",
29 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/order"
30 }
31 },
32 "emergency_requirement": {
33 "links": {
34 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_requirement",
35 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_requirement"
36 }
37 },
38 "emergency_verification": {
39 "links": {
40 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_verification",
41 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_verification"
42 }
43 },
44 "dids": {
45 "links": {
46 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/dids",
47 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/dids"
48 }
49 }
50 },
51 "meta": {
52 "setup_price": "0.0",
53 "monthly_price": "2.5"
54 }
55 }
56 ],
57 "meta": {
58 "total_records": 1,
59 "api_version": "2026-11-19"
60 },
61 "links": {
62 "first": "https://api.didww.com/v3/emergency_calling_services?filter%5Bcountry.id%5D=72f22218-ab1f-4933-a74d-a6467f3f6cb0&page%5Bnumber%5D=1&page%5Bsize%5D=50",
63 "last": "https://api.didww.com/v3/emergency_calling_services?filter%5Bcountry.id%5D=72f22218-ab1f-4933-a74d-a6467f3f6cb0&page%5Bnumber%5D=1&page%5Bsize%5D=50"
64 }
65}
http
1GET /v3/emergency_calling_services?filter%5Bstatus%5D=active&include=country 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?filter%5Bstatus%5D=active&include=country' -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 {
7 "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
8 "type": "emergency_calling_services",
9 "attributes": {
10 "number_type": "local",
11 "name": "E911 Service - New York Office",
12 "reference": "SHB-485120",
13 "status": "active",
14 "activated_at": "2026-01-15T10:30:00.000Z",
15 "canceled_at": null,
16 "renew_date": "2026-07-15",
17 "created_at": "2026-01-10T08:00:00.000Z"
18 },
19 "relationships": {
20 "country": {
21 "links": {
22 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/country",
23 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/country"
24 },
25 "data": {
26 "type": "countries",
27 "id": "72f22218-ab1f-4933-a74d-a6467f3f6cb0"
28 }
29 },
30 "order": {
31 "links": {
32 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/order",
33 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/order"
34 }
35 },
36 "emergency_requirement": {
37 "links": {
38 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_requirement",
39 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_requirement"
40 }
41 },
42 "emergency_verification": {
43 "links": {
44 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_verification",
45 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_verification"
46 }
47 },
48 "dids": {
49 "links": {
50 "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/dids",
51 "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/dids"
52 }
53 }
54 },
55 "meta": {
56 "setup_price": "0.0",
57 "monthly_price": "2.5"
58 }
59 }
60 ],
61 "included": [
62 {
63 "id": "72f22218-ab1f-4933-a74d-a6467f3f6cb0",
64 "type": "countries",
65 "attributes": {
66 "name": "United States",
67 "prefix": "1",
68 "iso": "US"
69 },
70 "relationships": {
71 "regions": {
72 "links": {
73 "self": "https://api.didww.com/v3/countries/72f22218-ab1f-4933-a74d-a6467f3f6cb0/relationships/regions",
74 "related": "https://api.didww.com/v3/countries/72f22218-ab1f-4933-a74d-a6467f3f6cb0/regions"
75 }
76 }
77 }
78 }
79 ],
80 "meta": {
81 "total_records": 1,
82 "api_version": "2026-11-19"
83 },
84 "links": {
85 "first": "https://api.didww.com/v3/emergency_calling_services?filter%5Bstatus%5D=active&include=country&page%5Bnumber%5D=1&page%5Bsize%5D=50",
86 "last": "https://api.didww.com/v3/emergency_calling_services?filter%5Bstatus%5D=active&include=country&page%5Bnumber%5D=1&page%5Bsize%5D=50"
87 }
88}
Other Responses#
Code |
Success |
Description |
|---|---|---|
400 |
No |
Bad Request. Malformed request: unknown filter, bad pagination or bad sort field. |
401 |
No |
|
403 |
No |
Forbidden. Emergency calling is not enabled for the account. |
429 |
No |
The request budget of the account for the current window is spent ( |