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

Includes

Value	Description
country	Country Object
did_group_type	DID Group Type 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:
status	string	No	No	The status field. Possible values: new, in_process, changes_required, active, pending_update, canceled.
country.id	string	No	No	The country.id field.
did_group_type.id	string	No	No	The did_group_type.id field.
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 are excluded from this sort.
created_at	The created_at field.

Examples

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

http

GET /v3/emergency_calling_services 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_calling_services -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": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "type": "emergency_calling_services",
            "attributes": {
                "name": "E911 Service - New York Office",
                "reference": "SHB-485120",
                "status": "active",
                "activated_at": "2026-01-15T10:30:00.000Z",
                "canceled_at": null,
                "renew_date": "2026-07-15",
                "created_at": "2026-01-10T08:00:00.000Z"
            },
            "relationships": {
                "country": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/country",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/country"
                    }
                },
                "did_group_type": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/did_group_type",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/did_group_type"
                    }
                },
                "order": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/order",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/order"
                    }
                },
                "emergency_requirement": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_requirement",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_requirement"
                    }
                },
                "emergency_verification": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/emergency_verification",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/emergency_verification"
                    }
                },
                "dids": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/relationships/dids",
                        "related": "https://api.didww.com/v3/emergency_calling_services/a1b2c3d4-e5f6-7890-abcd-ef1234567890/dids"
                    }
                }
            },
            "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_calling_services?page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "last": "https://api.didww.com/v3/emergency_calling_services?page%5Bnumber%5D=1&page%5Bsize%5D=50"
    }
}

Other Responses

Code	Success	Description
401	No	Unauthorized