# Get Address Verification

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

## Request

HTTP Method: `GET`

URI Path: `/v3/address_verifications/{id}`

Note

For all returned data attributes, see [Address Verifications Object](address-verifications-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| id | `string` | Yes | Unique ID identifier of the Address Verification. |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |

### Includes

| Value | Description |
| --- | --- |
| address | [Addresses Object](../addresses/address-object.html#addresses-object-v35) |
| dids | [DID Object](../../inventory-resources/did/did-object.html#did-object-v35) |
| dids.did\_group | [DID Group Object](../../coverage-resources/did-group/did-group-object.html#did-group-object-v35) |

## Examples

Approved VerificationRejected Verification

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/address_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]
```

curl

```
1curl -i -X GET https://api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

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": "address_verifications",
 8        "attributes": {
 9            "external_reference_id": null,
10            "service_description": null,
11            "callback_url": null,
12            "callback_method": null,
13            "status": "approved",
14            "reject_reasons": null,
15            "reject_comment": null,
16            "created_at": "2020-09-15T06:38:12.650Z",
17            "reference": "SHB-485120"
18        },
19        "relationships": {
20            "dids": {
21                "links": {
22                    "self": "https://api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/dids",
23                    "related": "https://api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/dids"
24                }
25            },
26            "address": {
27                "links": {
28                    "self": "https://api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/address",
29                    "related": "https://api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/address"
30                }
31            }
32        }
33    },
34    "meta": {
35        "api_version": "2026-11-19"
36    }
37}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET https://api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5   "data": {
 6      "id": "48e72d60-1884-4997-8755-fd2ba9f307bd",
 7      "type": "address_verifications",
 8      "attributes": {
 9         "external_reference_id": null,
10         "service_description": "string",
11         "callback_url": "http://192.0.2.10/test.php",
12         "callback_method": "get",
13         "status": "rejected",
14         "reject_reasons": [
15            "The proof of personal address is required",
16            "The DID cannot be used for the indicated service"
17         ],
18         "reject_comment": "Additional info from operator",
19         "reference": "VFG-606536",
20         "created_at": "2021-08-12T06:47:58.477Z"
21      },
22      "relationships": {
23         "dids": {
24            "links": {
25               "self": "https://api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd/relationships/dids",
26               "related": "https://api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd/dids"
27            }
28         },
29         "address": {
30            "links": {
31               "self": "https://api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd/relationships/address",
32               "related": "https://api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd/address"
33            }
34         }
35      }
36   },
37   "meta": {
38      "api_version": "2026-11-19"
39   }
40}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found). No address verification with that `id` belongs to the account. |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 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. |
