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
 5Authorization: Bearer [access 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 "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]" --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": null,
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-11-19"
41  }
42}

Other Responses#

Code

Success

Description

400

No

Bad Request. The body carries a member the API does not accept.

401

No

Unauthorized

403

No

Forbidden. Emergency calling is not enabled for the account. Also returned when the access token carries the read scope, which does not cover this method (title Insufficient scope, WWW-Authenticate: Bearer error="insufficient_scope"). See Scopes.

404

No

Not Found

422

No

Validation Error Object. external_reference_id is longer than 100 characters.

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.