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.

URI Query Parameters#

Name

Type

Is Required?

Description

include

string

No

Inclusion

filter[<filter_name>]

string

No

Filtering

fields[emergency_calling_services]

string

No

Sparse fieldsets

sort

string

No

Sorting

page[number]

integer

No

Page number.

page[size]

integer

No

Page size. Pagination defaults to 50 records per page. The maximum is 100.

Includes#

Value

Description

country

Country Object

order

Order Object

emergency_requirement

Emergency Requirement Object

emergency_verification

Emergency Verification Object

dids

DID Object

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#

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}

Other Responses#

Code

Success

Description

400

No

Bad Request. Malformed request: unknown filter, bad pagination or bad sort field.

401

No

Unauthorized

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.