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

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:
status	string	No	No	The status field. Possible values: pending, approved, rejected.
emergency_calling_service.id	string	No	No	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

Simple RequestFilter by statusInclude emergency_calling_service

http

GET /v3/emergency_verifications 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 -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": "89c0164e-752f-4995-a0fa-0ced21e60e4a",
            "type": "emergency_verifications",
            "attributes": {
                "reference": "SHB-485120",
                "status": "pending",
                "reject_reasons": [],
                "reject_comment": null,
                "callback_url": "https://example.com/callbacks/emergency",
                "callback_method": "post",
                "created_at": "2026-03-20T12:20:04.584Z",
                "external_reference_id": null
            },
            "relationships": {
                "address": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/address",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/address"
                    }
                },
                "emergency_calling_service": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/emergency_calling_service",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/emergency_calling_service"
                    }
                },
                "dids": {
                    "links": {
                        "self": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/relationships/dids",
                        "related": "https://api.didww.com/v3/emergency_verifications/89c0164e-752f-4995-a0fa-0ced21e60e4a/dids"
                    }
                }
            }
        },
        {
            "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": {
        "total_records": 2,
        "api_version": "2026-04-16"
    },
    "links": {
        "first": "https://api.didww.com/v3/emergency_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50",
        "last": "https://api.didww.com/v3/emergency_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50"
    }
}

Other Responses

Code	Success	Description
401	No	Unauthorized
400	No	Invalid resource for earlier API versions.