> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.idenfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Address Verification

> Verify customer addresses against official records using the iDenfy address verification API endpoint with country and address parameters.

<Note>
  **Requirements**

  * **API** key pair
  * Finances to perform **address verification**
</Note>

***

## Verify Address

<Info>
  **Authorization:** `API key pair`
  **Method:** `POST`
  **Endpoint:** `https://ivs.idenfy.com/api/v2/address-verification`
</Info>

### Request Parameters

| Parameter | Type   | Required | Explanation                                                                                                    |
| --------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------- |
| `address` | String | Yes      | Address for verification. Maximum length: 255 characters — longer values are rejected with a validation error. |
| `country` | String | No       | 2-digit ISO country code, e.g. "LT"                                                                            |

### No Match Found

If the address cannot be matched at all, the endpoint returns **`404 Not Found`** instead of a response body with `status: UNVERIFIED`. `UNVERIFIED` is only returned when a match *is* found but its verification code indicates the match is unverified or reverted — your integration needs to handle both the 404 case and the `UNVERIFIED` status.

<Note>
  You are only charged when a match is found. No funds are consumed when the endpoint returns `404`.
</Note>

### Response Values

| Key        | Type    | Explanation                                                                                                                                                                                             |
| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `address`  | String  | Address that was used to perform address verification.                                                                                                                                                  |
| `country`  | String  | Country that was passed during the address verification process.                                                                                                                                        |
| `status`   | String  | Status of the address. Possible values: `VERIFIED`, `PARTIALLY_VERIFIED`, `UNVERIFIED`.                                                                                                                 |
| `quality`  | String  | Quality score of the address. Possible values: `EXCELLENT`, `GOOD`, `AVERAGE`, `POOR`, `BAD`.                                                                                                           |
| `accuracy` | Integer | Accuracy of the address information. Maximum value is `100`. A lower value is returned if, for example, the postcode in the request differs from the actual postcode derived from the provided address. |

<Note>
  `BAD` also covers the case where the provider returns no quality code at all — `quality` is never `null`. Treat `BAD` as "poor quality or quality unknown."
</Note>

### Request Example

```json theme={"system"}
{
  "address": "Baršausko g. 59, LT-51423 Kaunas",
  "country": "LT"
}
```

### Response Example

```json theme={"system"}
{
  "address": "Baršausko g. 59, LT-51423 Kaunas",
  "country": "LT",
  "status": "VERIFIED",
  "quality": "GOOD",
  "accuracy": 99
}
```


## Related topics

- [Proof of Address](/guides/dashboard/settings/proof-of-address.md)
- [Additional KYB Features](/guides/dashboard/kyb/additional-features-kyb.md)
- [Checks Reference](/guides/dashboard/kyb/ai-reviwer-check-reference.md)
- [Proof of Address Verification](/guides/dashboard/kyc/proof-of-address-poa-verification.md)
- [Verification Statuses](/guides/dashboard/kyc/verification-statuses.md)