Address Verification

Requirements

API key pair
Finances to perform address verification

Verify Address

Authorization: API key pair Method: POST Endpoint: https://ivs.idenfy.com/api/v2/address-verification

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.

You are only charged when a match is found. No funds are consumed when the endpoint returns 404.

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.

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.”

Request Example

{
  "address": "Baršausko g. 59, LT-51423 Kaunas",
  "country": "LT"
}

Response Example

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

Start Here

ID Verification (KYC)

Business Verification (KYB)

AML Screening

Face Authentication

Age Estimation

Fraud Prevention

Bank Verification

Going Live

Reference

Verify Address

Request Parameters

No Match Found

Response Values

Request Example

Response Example

​Verify Address

​Request Parameters

​No Match Found

​Response Values

​Request Example

​Response Example

Verify Address

Request Parameters

No Match Found

Response Values

Request Example

Response Example