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 |
Includes#
Value |
Description |
|---|---|
country |
|
did_group_type |
Filters#
Filter Name |
Type |
Allow Blank |
Allow Array |
Filters by: |
|---|---|---|---|---|
id |
|
No |
Yes |
The Emergency Requirement |
country.id |
|
No |
No |
The |
did_group_type.id |
|
No |
No |
The |
Examples#
http
1GET /v3/emergency_requirements HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Api-Key: [API token]
curl
1curl -i -X GET https://api.didww.com/v3/emergency_requirements -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
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 "identity_type": "Any",
11 "address_area_level": "country",
12 "personal_area_level": "world_wide",
13 "business_area_level": "world_wide",
14 "address_mandatory_fields": [],
15 "personal_mandatory_fields": [],
16 "business_mandatory_fields": [],
17 "estimate_setup_time": "1-2 business days",
18 "requirement_restriction_message": null
19 },
20 "relationships": {
21 "country": {
22 "links": {
23 "self": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/country",
24 "related": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/country"
25 }
26 },
27 "did_group_type": {
28 "links": {
29 "self": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/did_group_type",
30 "related": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/did_group_type"
31 }
32 }
33 },
34 "meta": {
35 "setup_price": "0.0",
36 "monthly_price": "2.5"
37 }
38 },
39 {
40 "id": "d210e6e4-1716-4342-b04c-7a6ef6feb171",
41 "type": "emergency_requirements",
42 "attributes": {
43 "identity_type": "personal",
44 "address_area_level": "city",
45 "personal_area_level": "country",
46 "business_area_level": null,
47 "address_mandatory_fields": ["State/Province/Region"],
48 "personal_mandatory_fields": ["Birth Date", "Contact email"],
49 "business_mandatory_fields": [],
50 "estimate_setup_time": "1-2 business days",
51 "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."
52 },
53 "relationships": {
54 "country": {
55 "links": {
56 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
57 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
58 }
59 },
60 "did_group_type": {
61 "links": {
62 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type",
63 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type"
64 }
65 }
66 },
67 "meta": {
68 "setup_price": null,
69 "monthly_price": null
70 }
71 }
72 ],
73 "meta": {
74 "total_records": 2,
75 "api_version": "2026-04-16"
76 },
77 "links": {
78 "first": "https://api.didww.com/v3/emergency_requirements?page%5Bnumber%5D=1&page%5Bsize%5D=50",
79 "last": "https://api.didww.com/v3/emergency_requirements?page%5Bnumber%5D=1&page%5Bsize%5D=50"
80 }
81}
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
5Api-Key: [API 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 "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
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 "identity_type": "personal",
11 "address_area_level": "city",
12 "personal_area_level": "country",
13 "business_area_level": null,
14 "address_mandatory_fields": ["State/Province/Region"],
15 "personal_mandatory_fields": ["Birth Date", "Contact email"],
16 "business_mandatory_fields": [],
17 "estimate_setup_time": "1-2 business days",
18 "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."
19 },
20 "relationships": {
21 "country": {
22 "links": {
23 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
24 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
25 }
26 },
27 "did_group_type": {
28 "links": {
29 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type",
30 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type"
31 }
32 }
33 },
34 "meta": {
35 "setup_price": "0.0",
36 "monthly_price": "2.5"
37 }
38 }
39 ],
40 "meta": {
41 "total_records": 1,
42 "api_version": "2026-04-16"
43 },
44 "links": {
45 "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",
46 "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"
47 }
48}
http
1GET /v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890 HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Api-Key: [API token]
curl
1curl -i -X GET 'https://api.didww.com/v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890' -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
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 "identity_type": "personal",
11 "address_area_level": "city",
12 "personal_area_level": "country",
13 "business_area_level": null,
14 "address_mandatory_fields": ["State/Province/Region"],
15 "personal_mandatory_fields": ["Birth Date", "Contact email"],
16 "business_mandatory_fields": [],
17 "estimate_setup_time": "1-2 business days",
18 "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."
19 },
20 "relationships": {
21 "country": {
22 "links": {
23 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
24 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
25 }
26 },
27 "did_group_type": {
28 "links": {
29 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type",
30 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type"
31 }
32 }
33 },
34 "meta": {
35 "setup_price": "0.0",
36 "monthly_price": "2.5"
37 }
38 }
39 ],
40 "meta": {
41 "total_records": 1,
42 "api_version": "2026-04-16"
43 },
44 "links": {
45 "first": "https://api.didww.com/v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890&page%5Bnumber%5D=1&page%5Bsize%5D=50",
46 "last": "https://api.didww.com/v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890&page%5Bnumber%5D=1&page%5Bsize%5D=50"
47 }
48}
http
1GET /v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890&include=country HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Api-Key: [API token]
curl
1curl -i -X GET 'https://api.didww.com/v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890&include=country' -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
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 "identity_type": "personal",
11 "address_area_level": "city",
12 "personal_area_level": "country",
13 "business_area_level": null,
14 "address_mandatory_fields": ["State/Province/Region"],
15 "personal_mandatory_fields": ["Birth Date", "Contact email"],
16 "business_mandatory_fields": [],
17 "estimate_setup_time": "1-2 business days",
18 "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."
19 },
20 "relationships": {
21 "country": {
22 "links": {
23 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country",
24 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country"
25 },
26 "data": {
27 "type": "countries",
28 "id": "72f22218-ab1f-4933-a74d-a6467f3f6cb0"
29 }
30 },
31 "did_group_type": {
32 "links": {
33 "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type",
34 "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type"
35 }
36 }
37 },
38 "meta": {
39 "setup_price": "0.0",
40 "monthly_price": "2.5"
41 }
42 },
43 {
44 "id": "a3b4c5d6-7890-4abc-def0-123456789012",
45 "type": "emergency_requirements",
46 "attributes": {
47 "identity_type": "Any",
48 "address_area_level": "country",
49 "personal_area_level": "world_wide",
50 "business_area_level": "world_wide",
51 "address_mandatory_fields": [],
52 "personal_mandatory_fields": [],
53 "business_mandatory_fields": [],
54 "estimate_setup_time": "1-2 business days",
55 "requirement_restriction_message": null
56 },
57 "relationships": {
58 "country": {
59 "links": {
60 "self": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/relationships/country",
61 "related": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/country"
62 },
63 "data": {
64 "type": "countries",
65 "id": "b1c2d3e4-f567-4890-abcd-ef0123456789"
66 }
67 },
68 "did_group_type": {
69 "links": {
70 "self": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/relationships/did_group_type",
71 "related": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/did_group_type"
72 }
73 }
74 },
75 "meta": {
76 "setup_price": "0.0",
77 "monthly_price": "0.2"
78 }
79 }
80 ],
81 "included": [
82 {
83 "id": "72f22218-ab1f-4933-a74d-a6467f3f6cb0",
84 "type": "countries",
85 "attributes": {
86 "name": "United States",
87 "prefix": "1",
88 "iso": "US"
89 },
90 "relationships": {
91 "regions": {
92 "links": {
93 "self": "https://api.didww.com/v3/countries/72f22218-ab1f-4933-a74d-a6467f3f6cb0/relationships/regions",
94 "related": "https://api.didww.com/v3/countries/72f22218-ab1f-4933-a74d-a6467f3f6cb0/regions"
95 }
96 }
97 }
98 },
99 {
100 "id": "b1c2d3e4-f567-4890-abcd-ef0123456789",
101 "type": "countries",
102 "attributes": {
103 "name": "Canada",
104 "prefix": "1",
105 "iso": "CA"
106 },
107 "relationships": {
108 "regions": {
109 "links": {
110 "self": "https://api.didww.com/v3/countries/b1c2d3e4-f567-4890-abcd-ef0123456789/relationships/regions",
111 "related": "https://api.didww.com/v3/countries/b1c2d3e4-f567-4890-abcd-ef0123456789/regions"
112 }
113 }
114 }
115 }
116 ],
117 "meta": {
118 "total_records": 2,
119 "api_version": "2026-04-16"
120 },
121 "links": {
122 "first": "https://api.didww.com/v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890&include=country&page%5Bnumber%5D=1&page%5Bsize%5D=50",
123 "last": "https://api.didww.com/v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890&include=country&page%5Bnumber%5D=1&page%5Bsize%5D=50"
124 }
125}
Other Responses#
Code |
Success |
Description |
|---|---|---|
400 |
No |
Invalid resource. Example detail: |
401 |
No |
|
403 |
No |
Forbidden. Example detail: |