# 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[<filter\_name>] | `string` | No | [Filtering](../../../specification/filtering.html#api-filters) |
| fields[emergency\_requirements] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |
| page[number] | `integer` | No | [Page number](../../../specification/pagination.html#api-pagination). |
| page[size] | `integer` | No | [Page size](../../../specification/pagination.html#api-pagination). Pagination defaults to `50` records per page. The maximum is `100`. |

### Includes

| Value | Description |
| --- | --- |
| country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v35) |

### Filters

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| id | `string` | No | Yes | The Emergency Requirement `id` field. |
| country.id | `string` | No | Yes | The `country.id` field. |
| number\_type | `string` | No | Yes | The Emergency Requirement `number_type` field. Accepted values: `local`, `national`, `mobile`, `toll_free`, `shared_cost`, `global`. |

## Examples

Simple RequestFilter by country.idFilter by number\_typeInclude country while filtered by number\_type

[[DIDWW-API-EXAMPLE-START]]

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}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request) |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 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 (`too_many_requests`). `Retry-After` gives the number of seconds to wait. |
