Get Emergency Verifications#

Returns the emergency verifications status and reason if the verification was rejected.

Request#

HTTP Method: GET

URI Path: /v3/emergency_verifications

Note

For all returned data attributes, see Emergency Verification Object.

URI Query Parameters#

Name

Type

Is Required?

Description

include

string

No

Inclusion

filter[<filter_name>]

string

No

Filtering

fields[emergency_verifications]

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

address

Addresses Object

emergency_calling_service

Emergency Calling Service 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: pending, approved, rejected.

emergency_calling_service.id

string

No

Yes

The emergency_calling_service.id field.

external_reference_id

string

Yes

No

The external_reference_id field.

Sorting#

Value

Sorts by:

created_at

The created_at field.

external_reference_id

The external_reference_id field.

Examples#

http

1GET /v3/emergency_verifications 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_verifications -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": "89c0164e-752f-4995-a0fa-0ced21e60e4a",
 8            "type": "emergency_verifications",
 9            "attributes": {
10                "reference": "SHB-485120",
11                "status": "pending",
12                "reject_reasons": null,
13                "reject_comment": null,
14                "callback_url": "https://example.com/callbacks/emergency",
15                "callback_method": "post",
16                "created_at": "2026-03-20T12:20:04.584Z",
17                "external_reference_id": null
18            },
19            "relationships": {
20                "address": {
21                    "links": {
22                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/address",
23                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/address"
24                    }
25                },
26                "emergency_calling_service": {
27                    "links": {
28                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/emergency_calling_service",
29                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/emergency_calling_service"
30                    }
31                },
32                "dids": {
33                    "links": {
34                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/dids",
35                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/dids"
36                    }
37                }
38            }
39        },
40        {
41            "id": "c8e004b0-87ec-4987-b4fb-ee89db099f0e",
42            "type": "emergency_verifications",
43            "attributes": {
44                "reference": "SHB-991234",
45                "status": "approved",
46                "reject_reasons": null,
47                "reject_comment": null,
48                "callback_url": null,
49                "callback_method": null,
50                "created_at": "2026-01-10T09:00:00.000Z",
51                "external_reference_id": null
52            },
53            "relationships": {
54                "address": {
55                    "links": {
56                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/address",
57                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/address"
58                    }
59                },
60                "emergency_calling_service": {
61                    "links": {
62                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/emergency_calling_service",
63                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/emergency_calling_service"
64                    }
65                },
66                "dids": {
67                    "links": {
68                        "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/dids",
69                        "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/dids"
70                    }
71                }
72            }
73        }
74    ],
75    "meta": {
76        "total_records": 2,
77        "api_version": "2026-11-19"
78    },
79    "links": {
80        "first": "https://api.didww.com/v3/emergency_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50",
81        "last": "https://api.didww.com/v3/emergency_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50"
82    }
83}

Other Responses#

Code

Success

Description

400

No

Bad Request

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.