# 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/`

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-v34) |
| dids | [DID Object](../../inventory-resources/did/did-object.html#did-object-v34) |
| dids.did\_group | [DID Group Object](../../coverage-resources/did-group/did-group-object.html#did-group-object-v34) |

## Examples

Approved VerificationRejected Verification

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e 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/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e -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": "c8e004b0-87ec-4987-b4fb-ee89db099f0e",
        "type": "address_verifications",
        "attributes": {
            "external_reference_id": null,
            "service_description": null,
            "callback_url": null,
            "callback_method": null,
            "status": "approved",
            "reject_reasons": [],
            "reject_comment": null,
            "created_at": "2020-09-15T06:38:12.650Z",
            "reference": "SHB-485120"
        },
        "relationships": {
            "dids": {
                "links": {
                    "self": "https://sandbox-api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/dids",
                    "related": "https://sandbox-api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/dids"
                }
            },
            "address": {
                "links": {
                    "self": "https://sandbox-api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/relationships/address",
                    "related": "https://sandbox-api.didww.com/v3/address_verifications/c8e004b0-87ec-4987-b4fb-ee89db099f0e/address"
                }
            }
        }
    },
    "meta": {
        "api_version": "2026-04-16"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd 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/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd -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": "48e72d60-1884-4997-8755-fd2ba9f307bd",
      "type": "address_verifications",
      "attributes": {
         "external_reference_id": null,
         "service_description": "string",
         "callback_url": "http://192.0.2.10/test.php",
         "callback_method": "get",
         "status": "rejected",
         "reject_reasons": [
            "The proof of personal address is required",
            "The DID cannot be used for the indicated service"
         ],
         "reject_comment": "Additional info from operator",
         "reference": "VFG-606536",
         "created_at": "2021-08-12T06:47:58.477Z"
      },
      "relationships": {
         "dids": {
            "links": {
               "self": "https://sandbox-api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd/relationships/dids",
               "related": "https://sandbox-api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd/dids"
            }
         },
         "address": {
            "links": {
               "self": "https://sandbox-api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd/relationships/address",
               "related": "https://sandbox-api.didww.com/v3/address_verifications/48e72d60-1884-4997-8755-fd2ba9f307bd/address"
            }
         }
      }
   },
   "meta": {
      "api_version": "2026-04-16"
   }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |

On this page