# 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](emergency-calling-service-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\_calling\_services] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |
| sort | `string` | No | [Sorting](../../../specification/sorting.html#api-sorting) |
| 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) |
| order | [Order Object](../../inventory-resources/order/order-object.html#order-object-v35) |
| emergency\_requirement | [Emergency Requirement Object](../emergency-requirements/emergency-requirement-object.html#emergency-requirement-object-v35) |
| emergency\_verification | [Emergency Verification Object](../emergency-verifications/emergency-verification-object.html#emergency-verification-object-v35) |
| dids | [DID Object](../../inventory-resources/did/did-object.html#did-object-v35) |

### Filters

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| id | `string` | No | Yes | The `id` field. |
| status | `string` | No | No | The `status` field. Possible values: `new`, `in_process`, `changes_required`, `active`, `pending_update`, `canceled`. |
| country.id | `string` | No | Yes | The `country.id` field. |
| number\_type | `string` | No | Yes | The `number_type` field. Accepted values: `local`, `national`, `mobile`, `toll_free`, `shared_cost`, `global`. |
| address.id | `string` | No | No | The `address.id` field of the last verification linked to the emergency calling service. |
| identity.id | `string` | No | No | The `identity.id` field of the address used in the last verification linked to the emergency calling service. |
| name | `string` | No | No | The `name` field. |
| reference | `string` | No | No | The `reference` field. |

### Sorting

| Value | Sorts by: |
| --- | --- |
| name | The `name` field. |
| status | The `status` field. Possible values: `new`, `in_process`, `changes_required`, `active`, `pending_update`, `canceled`. |
| country.name | The related country name. |
| renew\_date | The `renew_date` field. Canceled services have no `renew_date` and are sorted as `null` values. |
| created\_at | The `created_at` field. |

## Examples

Simple RequestFilter by statusFilter by country.idInclude country while filtered by status

[[DIDWW-API-EXAMPLE-START]]

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

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request). Malformed request: unknown filter, bad pagination or bad sort field. |
| 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. |
