Update Emergency Verification#

Update the settings of a single Emergency Verification owned by your account.

Request#

HTTP Method: PATCH

URI Path: /v3/emergency_verifications/{id}

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique ID identifier of the Emergency Verification.

Request Body Object Attributes#

Name

Type

Is Required?

Description

external_reference_id

string

No

Optional identifier for the emergency verification in the customer’s external system. Maximum length is 100 characters.

Examples#

http

 1PATCH /v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e HTTP/1.1
 2Host: api.didww.com
 3Content-Type: application/vnd.api+json
 4Accept: application/vnd.api+json
 5Api-Key: [API token]
 6
 7{
 8  "data": {
 9    "id": "c8e004b0-87ec-4987-b4fb-ee89db099f0e",
10    "type": "emergency_verifications",
11    "attributes": {
12      "external_reference_id": "test"
13    }
14  }
15}

curl

1curl -i -X PATCH 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" --data-raw '{"data": {"attributes": {"external_reference_id": "test"}, "id": "c8e004b0-87ec-4987-b4fb-ee89db099f0e", "type": "emergency_verifications"}}'

response

 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "c8e004b0-87ec-4987-b4fb-ee89db099f0e",
 7    "type": "emergency_verifications",
 8    "attributes": {
 9      "reference": "SHB-991234",
10      "status": "approved",
11      "reject_reasons": [],
12      "reject_comment": null,
13      "callback_url": null,
14      "callback_method": null,
15      "created_at": "2026-01-10T09:00:00.000Z",
16      "external_reference_id": "test"
17    },
18    "relationships": {
19      "address": {
20        "links": {
21          "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/address",
22          "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/address"
23        }
24      },
25      "emergency_calling_service": {
26        "links": {
27          "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/emergency_calling_service",
28          "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/emergency_calling_service"
29        }
30      },
31      "dids": {
32        "links": {
33          "self": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/dids",
34          "related": "https://api.didww.com/v3/emergency_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/dids"
35        }
36      }
37    }
38  },
39  "meta": {
40    "api_version": "2026-04-16"
41  }
42}

Other Responses#

Code

Success

Description

404

No

Not Found

401

No

Unauthorized