# 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](emergency-requirement-object.html). ### URI Query Parameters | Name | Type | Is Required? | Description | | --- | --- | --- | --- | | include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) | | filter[] | `string` | No | [Filtering](../../../specification/filtering.html#api-filters) | | fields[emergency\_requirements] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) | ### Includes | Value | Description | | --- | --- | | country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) | | did\_group\_type | [DID Group Type Object](../../coverage-resources/did-group-type/did-group-type-object.html#did-group-type-object-v34) | ### Filters | Filter Name | Type | Allow Blank | Allow Array | Filters by: | | --- | --- | --- | --- | --- | | id | `string` | No | Yes | The Emergency Requirement `id` field. | | country.id | `string` | No | No | The `country.id` field. | | did\_group\_type.id | `string` | No | No | The `did_group_type.id` field. | ## Examples Simple RequestFilter by country.idFilter by did\_group\_type.idInclude country while filtered by did\_group\_type.id [[DIDWW-API-EXAMPLE-START]] http ``` GET /v3/emergency_requirements HTTP/1.1 Host: api.didww.com Content-Type: application/vnd.api+json Accept: application/vnd.api+json Api-Key: [API token] ``` curl ``` curl -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 ``` HTTP/1.1 200 OK Content-Type: application/vnd.api+json { "data": [ { "id": "3f3be6a6-a513-4509-bd9b-945e599e16f5", "type": "emergency_requirements", "attributes": { "identity_type": "Any", "address_area_level": "country", "personal_area_level": "world_wide", "business_area_level": "world_wide", "address_mandatory_fields": [], "personal_mandatory_fields": [], "business_mandatory_fields": [], "estimate_setup_time": "1-2 business days", "requirement_restriction_message": null }, "relationships": { "country": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/country", "related": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/country" } }, "did_group_type": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/relationships/did_group_type", "related": "https://api.didww.com/v3/emergency_requirements/3f3be6a6-a513-4509-bd9b-945e599e16f5/did_group_type" } } }, "meta": { "setup_price": "0.0", "monthly_price": "2.5" } }, { "id": "d210e6e4-1716-4342-b04c-7a6ef6feb171", "type": "emergency_requirements", "attributes": { "identity_type": "personal", "address_area_level": "city", "personal_area_level": "country", "business_area_level": null, "address_mandatory_fields": ["State/Province/Region"], "personal_mandatory_fields": ["Birth Date", "Contact email"], "business_mandatory_fields": [], "estimate_setup_time": "1-2 business days", "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." }, "relationships": { "country": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country", "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country" } }, "did_group_type": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type", "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type" } } }, "meta": { "setup_price": null, "monthly_price": null } } ], "meta": { "total_records": 2, "api_version": "2026-04-16" }, "links": { "first": "https://api.didww.com/v3/emergency_requirements?page%5Bnumber%5D=1&page%5Bsize%5D=50", "last": "https://api.didww.com/v3/emergency_requirements?page%5Bnumber%5D=1&page%5Bsize%5D=50" } } ``` [[DIDWW-API-EXAMPLE-END]] [[DIDWW-API-EXAMPLE-START]] http ``` GET /v3/emergency_requirements?filter%5Bcountry.id%5D=72f22218-ab1f-4933-a74d-a6467f3f6cb0 HTTP/1.1 Host: api.didww.com Content-Type: application/vnd.api+json Accept: application/vnd.api+json Api-Key: [API token] ``` curl ``` curl -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 ``` HTTP/1.1 200 OK Content-Type: application/vnd.api+json { "data": [ { "id": "d210e6e4-1716-4342-b04c-7a6ef6feb171", "type": "emergency_requirements", "attributes": { "identity_type": "personal", "address_area_level": "city", "personal_area_level": "country", "business_area_level": null, "address_mandatory_fields": ["State/Province/Region"], "personal_mandatory_fields": ["Birth Date", "Contact email"], "business_mandatory_fields": [], "estimate_setup_time": "1-2 business days", "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." }, "relationships": { "country": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country", "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country" } }, "did_group_type": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type", "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type" } } }, "meta": { "setup_price": "0.0", "monthly_price": "2.5" } } ], "meta": { "total_records": 1, "api_version": "2026-04-16" }, "links": { "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", "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" } } ``` [[DIDWW-API-EXAMPLE-END]] [[DIDWW-API-EXAMPLE-START]] http ``` GET /v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890 HTTP/1.1 Host: api.didww.com Content-Type: application/vnd.api+json Accept: application/vnd.api+json Api-Key: [API token] ``` curl ``` curl -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 ``` HTTP/1.1 200 OK Content-Type: application/vnd.api+json { "data": [ { "id": "d210e6e4-1716-4342-b04c-7a6ef6feb171", "type": "emergency_requirements", "attributes": { "identity_type": "personal", "address_area_level": "city", "personal_area_level": "country", "business_area_level": null, "address_mandatory_fields": ["State/Province/Region"], "personal_mandatory_fields": ["Birth Date", "Contact email"], "business_mandatory_fields": [], "estimate_setup_time": "1-2 business days", "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." }, "relationships": { "country": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country", "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country" } }, "did_group_type": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type", "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type" } } }, "meta": { "setup_price": "0.0", "monthly_price": "2.5" } } ], "meta": { "total_records": 1, "api_version": "2026-04-16" }, "links": { "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", "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" } } ``` [[DIDWW-API-EXAMPLE-END]] [[DIDWW-API-EXAMPLE-START]] http ``` GET /v3/emergency_requirements?filter%5Bdid_group_type.id%5D=8a9bcd12-3456-789a-bcde-f01234567890&include=country HTTP/1.1 Host: api.didww.com Content-Type: application/vnd.api+json Accept: application/vnd.api+json Api-Key: [API token] ``` curl ``` curl -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 ``` HTTP/1.1 200 OK Content-Type: application/vnd.api+json { "data": [ { "id": "d210e6e4-1716-4342-b04c-7a6ef6feb171", "type": "emergency_requirements", "attributes": { "identity_type": "personal", "address_area_level": "city", "personal_area_level": "country", "business_area_level": null, "address_mandatory_fields": ["State/Province/Region"], "personal_mandatory_fields": ["Birth Date", "Contact email"], "business_mandatory_fields": [], "estimate_setup_time": "1-2 business days", "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." }, "relationships": { "country": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/country", "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/country" }, "data": { "type": "countries", "id": "72f22218-ab1f-4933-a74d-a6467f3f6cb0" } }, "did_group_type": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/relationships/did_group_type", "related": "https://api.didww.com/v3/emergency_requirements/d210e6e4-1716-4342-b04c-7a6ef6feb171/did_group_type" } } }, "meta": { "setup_price": "0.0", "monthly_price": "2.5" } }, { "id": "a3b4c5d6-7890-4abc-def0-123456789012", "type": "emergency_requirements", "attributes": { "identity_type": "Any", "address_area_level": "country", "personal_area_level": "world_wide", "business_area_level": "world_wide", "address_mandatory_fields": [], "personal_mandatory_fields": [], "business_mandatory_fields": [], "estimate_setup_time": "1-2 business days", "requirement_restriction_message": null }, "relationships": { "country": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/relationships/country", "related": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/country" }, "data": { "type": "countries", "id": "b1c2d3e4-f567-4890-abcd-ef0123456789" } }, "did_group_type": { "links": { "self": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/relationships/did_group_type", "related": "https://api.didww.com/v3/emergency_requirements/a3b4c5d6-7890-4abc-def0-123456789012/did_group_type" } } }, "meta": { "setup_price": "0.0", "monthly_price": "0.2" } } ], "included": [ { "id": "72f22218-ab1f-4933-a74d-a6467f3f6cb0", "type": "countries", "attributes": { "name": "United States", "prefix": "1", "iso": "US" }, "relationships": { "regions": { "links": { "self": "https://api.didww.com/v3/countries/72f22218-ab1f-4933-a74d-a6467f3f6cb0/relationships/regions", "related": "https://api.didww.com/v3/countries/72f22218-ab1f-4933-a74d-a6467f3f6cb0/regions" } } } }, { "id": "b1c2d3e4-f567-4890-abcd-ef0123456789", "type": "countries", "attributes": { "name": "Canada", "prefix": "1", "iso": "CA" }, "relationships": { "regions": { "links": { "self": "https://api.didww.com/v3/countries/b1c2d3e4-f567-4890-abcd-ef0123456789/relationships/regions", "related": "https://api.didww.com/v3/countries/b1c2d3e4-f567-4890-abcd-ef0123456789/regions" } } } } ], "meta": { "total_records": 2, "api_version": "2026-04-16" }, "links": { "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", "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" } } ``` [[DIDWW-API-EXAMPLE-END]] ## Other Responses | Code | Success | Description | | --- | --- | --- | | 400 | No | Invalid resource. Example detail: `emergency_requirements are not supported in 2022-05-10 DIDWW API version`. | | 401 | No | [Unauthorized](../../../configuration.html#api-key) | | 403 | No | Forbidden. Example detail: `Emergency plan is not assigned to the Customer`. | On this page