Get Emergency Requirements#
Returns the list of emergency requirements.
Request#
HTTP Method: GET
URI Path: /v3/emergency_requirements
Note
For all returned data attributes, see Emergency Requirement Object.
URI Query Parameters#
Name |
Type |
Is Required? |
Description |
|---|---|---|---|
include |
|
No |
|
filter[<filter_name>] |
|
No |
|
fields[emergency_requirements] |
|
No |
|
page[number] |
|
No |
|
page[size] |
|
No |
Page size. Pagination defaults to |
Includes#
Value |
Description |
|---|---|
country |
Filters#
Filter Name |
Type |
Allow Blank |
Allow Array |
Filters by: |
|---|---|---|---|---|
id |
|
No |
Yes |
The Emergency Requirement |
country.id |
|
No |
Yes |
The |
number_type |
|
No |
Yes |
The Emergency Requirement |
Examples#
http
1GET /v3/emergency_requirements 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_requirements -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": "3f3be6a6-a513-4509-bd9b-945e599e16f5",
8 "type": "emergency_requirements",
9 "attributes": {
10 "number_type": "local",
11 "identity_type": "any",
12 "address_area_level": "country",
13 "personal_area_level": "world_wide",
14 "business_area_level": "world_wide",
15 "address_mandatory_fields": [],
16 "personal_mandatory_fields": [],
17 "business_mandatory_fields": [],
18 "estimate_setup_time": "1-2 business days",
19 "requirement_restriction_message": null
20 },
21 "relationships": {
22 "country": {
23 "links": {
24 "self": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/country",
25 "related": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/country"
26 }
27 }
28 },
29 "meta": {
30 "setup_price": "0.0",
31 "monthly_price": "2.5"
32 }
33 },
34 {
35 "id": "d210e6e4-1716-4342-b04c-7a6ef6feb171",
36 "type": "emergency_requirements",
37 "attributes": {
38 "number_type": "local",
39 "identity_type": "personal",
40 "address_area_level": "city",
41 "personal_area_level": "country",
42 "business_area_level": null,
43 "address_mandatory_fields": ["area"],
44 "personal_mandatory_fields": ["birth_date", "contact_email"],
45 "business_mandatory_fields": [],
46 "estimate_setup_time": "1-2 business days",
47 "requirement_restriction_message": "USA Local DID emergency registration requirements:\r\n\r\n1. Name, last name and contact phone number.\r\n2. Current address must be from the same city as the DID ordered (street, building number, postal code, city).\r\n\r\nEmergency calling will not be activated until full registration details are provided and approved."
48 },
49 "relationships": {
50 "country": {
51 "links": {
52 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
53 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
54 }
55 }
56 },
57 "meta": {
58 "setup_price": null,
59 "monthly_price": null
60 }
61 }
62 ],
63 "meta": {
64 "total_records": 2,
65 "api_version": "2026-11-19"
66 },
67 "links": {
68 "first": "https://api.didww.com/v3/emergency_requirements?page%5Bnumber%5D=1&page%5Bsize%5D=50",
69 "last": "https://api.didww.com/v3/emergency_requirements?page%5Bnumber%5D=1&page%5Bsize%5D=50"
70 }
71}
http
1GET /v3/emergency_requirements?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_requirements?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": "d210e6e4-1716-4342-b04c-7a6ef6feb171",
8 "type": "emergency_requirements",
9 "attributes": {
10 "number_type": "local",
11 "identity_type": "personal",
12 "address_area_level": "city",
13 "personal_area_level": "country",
14 "business_area_level": null,
15 "address_mandatory_fields": ["area"],
16 "personal_mandatory_fields": ["birth_date", "contact_email"],
17 "business_mandatory_fields": [],
18 "estimate_setup_time": "1-2 business days",
19 "requirement_restriction_message": "USA Local DID emergency registration requirements:\r\n\r\n1. Name, last name and contact phone number.\r\n2. Current address must be from the same city as the DID ordered (street, building number, postal code, city).\r\n\r\nEmergency calling will not be activated until full registration details are provided and approved."
20 },
21 "relationships": {
22 "country": {
23 "links": {
24 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
25 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
26 }
27 }
28 },
29 "meta": {
30 "setup_price": "0.0",
31 "monthly_price": "2.5"
32 }
33 }
34 ],
35 "meta": {
36 "total_records": 1,
37 "api_version": "2026-11-19"
38 },
39 "links": {
40 "first": "https://api.didww.com/v3/emergency_requirements?filter%5Bcountry.id%5D=72f22218-ab1f-4933-a74d-a6467f3f6cb0&page%5Bnumber%5D=1&page%5Bsize%5D=50",
41 "last": "https://api.didww.com/v3/emergency_requirements?filter%5Bcountry.id%5D=72f22218-ab1f-4933-a74d-a6467f3f6cb0&page%5Bnumber%5D=1&page%5Bsize%5D=50"
42 }
43}
http
1GET /v3/emergency_requirements?filter%5Bnumber_type%5D=local 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_requirements?filter%5Bnumber_type%5D=local' -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": "d210e6e4-1716-4342-b04c-7a6ef6feb171",
8 "type": "emergency_requirements",
9 "attributes": {
10 "number_type": "local",
11 "identity_type": "personal",
12 "address_area_level": "city",
13 "personal_area_level": "country",
14 "business_area_level": null,
15 "address_mandatory_fields": ["area"],
16 "personal_mandatory_fields": ["birth_date", "contact_email"],
17 "business_mandatory_fields": [],
18 "estimate_setup_time": "1-2 business days",
19 "requirement_restriction_message": "USA Local DID emergency registration requirements:\r\n\r\n1. Name, last name and contact phone number.\r\n2. Current address must be from the same city as the DID ordered (street, building number, postal code, city).\r\n\r\nEmergency calling will not be activated until full registration details are provided and approved."
20 },
21 "relationships": {
22 "country": {
23 "links": {
24 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
25 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
26 }
27 }
28 },
29 "meta": {
30 "setup_price": "0.0",
31 "monthly_price": "2.5"
32 }
33 }
34 ],
35 "meta": {
36 "total_records": 1,
37 "api_version": "2026-11-19"
38 },
39 "links": {
40 "first": "https://api.didww.com/v3/emergency_requirements?filter%5Bnumber_type%5D=local&page%5Bnumber%5D=1&page%5Bsize%5D=50",
41 "last": "https://api.didww.com/v3/emergency_requirements?filter%5Bnumber_type%5D=local&page%5Bnumber%5D=1&page%5Bsize%5D=50"
42 }
43}
http
1GET /v3/emergency_requirements?filter%5Bnumber_type%5D=local&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_requirements?filter%5Bnumber_type%5D=local&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": "d210e6e4-1716-4342-b04c-7a6ef6feb171",
8 "type": "emergency_requirements",
9 "attributes": {
10 "number_type": "local",
11 "identity_type": "personal",
12 "address_area_level": "city",
13 "personal_area_level": "country",
14 "business_area_level": null,
15 "address_mandatory_fields": ["area"],
16 "personal_mandatory_fields": ["birth_date", "contact_email"],
17 "business_mandatory_fields": [],
18 "estimate_setup_time": "1-2 business days",
19 "requirement_restriction_message": "USA Local DID emergency registration requirements:\r\n\r\n1. Name, last name and contact phone number.\r\n2. Current address must be from the same city as the DID ordered (street, building number, postal code, city).\r\n\r\nEmergency calling will not be activated until full registration details are provided and approved."
20 },
21 "relationships": {
22 "country": {
23 "links": {
24 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
25 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
26 },
27 "data": {
28 "type": "countries",
29 "id": "72f22218-ab1f-4933-a74d-a6467f3f6cb0"
30 }
31 }
32 },
33 "meta": {
34 "setup_price": "0.0",
35 "monthly_price": "2.5"
36 }
37 },
38 {
39 "id": "a3b4c5d6-7890-4abc-def0-123456789012",
40 "type": "emergency_requirements",
41 "attributes": {
42 "number_type": "local",
43 "identity_type": "any",
44 "address_area_level": "country",
45 "personal_area_level": "world_wide",
46 "business_area_level": "world_wide",
47 "address_mandatory_fields": [],
48 "personal_mandatory_fields": [],
49 "business_mandatory_fields": [],
50 "estimate_setup_time": "1-2 business days",
51 "requirement_restriction_message": null
52 },
53 "relationships": {
54 "country": {
55 "links": {
56 "self": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/relationships/country",
57 "related": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/country"
58 },
59 "data": {
60 "type": "countries",
61 "id": "b1c2d3e4-f567-4890-abcd-ef0123456789"
62 }
63 }
64 },
65 "meta": {
66 "setup_price": "0.0",
67 "monthly_price": "0.2"
68 }
69 }
70 ],
71 "included": [
72 {
73 "id": "72f22218-ab1f-4933-a74d-a6467f3f6cb0",
74 "type": "countries",
75 "attributes": {
76 "name": "United States",
77 "prefix": "1",
78 "iso": "US"
79 },
80 "relationships": {
81 "regions": {
82 "links": {
83 "self": "https://api.didww.com/v3/countries/72f22218-ab1f-4933-a74d-a6467f3f6cb0/relationships/regions",
84 "related": "https://api.didww.com/v3/countries/72f22218-ab1f-4933-a74d-a6467f3f6cb0/regions"
85 }
86 }
87 }
88 },
89 {
90 "id": "b1c2d3e4-f567-4890-abcd-ef0123456789",
91 "type": "countries",
92 "attributes": {
93 "name": "Canada",
94 "prefix": "1",
95 "iso": "CA"
96 },
97 "relationships": {
98 "regions": {
99 "links": {
100 "self": "https://api.didww.com/v3/countries/b1c2d3e4-f567-4890-abcd-ef0123456789/relationships/regions",
101 "related": "https://api.didww.com/v3/countries/b1c2d3e4-f567-4890-abcd-ef0123456789/regions"
102 }
103 }
104 }
105 }
106 ],
107 "meta": {
108 "total_records": 2,
109 "api_version": "2026-11-19"
110 },
111 "links": {
112 "first": "https://api.didww.com/v3/emergency_requirements?filter%5Bnumber_type%5D=local&include=country&page%5Bnumber%5D=1&page%5Bsize%5D=50",
113 "last": "https://api.didww.com/v3/emergency_requirements?filter%5Bnumber_type%5D=local&include=country&page%5Bnumber%5D=1&page%5Bsize%5D=50"
114 }
115}
Other Responses#
Code |
Success |
Description |
|---|---|---|
400 |
No |
|
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 ( |