# 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

Update external\_reference\_id

[[DIDWW-API-EXAMPLE-START]]

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}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request). The body carries a member the API does not accept. |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 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](../../authentication.html#authentication-scopes-v35). |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) |
| 422 | No | [Validation Error Object](../../../specification/errors/index.html#api-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. |
