Get Emergency Verification

Returns a single emergency verification status and reason if the verification was rejected.

Request

HTTP Method: GET

URI Path: /v3/emergency_verifications/{id}

Note

For all returned data attributes, see Emergency Verification Object.

URI Query Parameters

Name	Type	Is Required?	Description
id	string	Yes	Unique ID identifier of the Emergency Verification.
include	string	No	Inclusion

Includes

Value	Description
address	Addresses Object
emergency_calling_service	Emergency Calling Service Object
dids	DID Object

Examples

Approved VerificationRejected Verification

http

GET /v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e 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_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e -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": "c8e004b0-87ec-4987-b4fb-ee89db099f0e",
        "type": "emergency_verifications",
        "attributes": {
            "reference": "SHB-991234",
            "status": "approved",
            "reject_reasons": [],
            "reject_comment": null,
            "callback_url": null,
            "callback_method": null,
            "created_at": "2026-01-10T09:00:00.000Z",
            "external_reference_id": null
        },
        "relationships": {
            "address": {
                "links": {
                    "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/address",
                    "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/address"
                }
            },
            "emergency_calling_service": {
                "links": {
                    "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/emergency_calling_service",
                    "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/emergency_calling_service"
                }
            },
            "dids": {
                "links": {
                    "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/dids",
                    "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/dids"
                }
            }
        }
    },
    "meta": {
        "api_version": "2026-04-16"
    }
}

Other Responses

Code	Success	Description
401	No	Unauthorized
403	No	Forbidden. Example detail: Emergency plan is not assigned to the customer.
404	No	Not Found