logo

Welcome to AddressVerify API

AddressVerify offers a REST API for validating and enriching U.S. residential address data. Our service enables developers to verify addresses, identify home types, and obtain estimated property values.

This documentation provides a comprehensive guide to integrating and using the AddressVerify API. You'll find detailed information on endpoints, request formats, and response structures, along with code examples to help you get started quickly.

Whether you're building applications for marketing, lead generation, home services, or address verification, this guide will help you leverage AddressVerify's capabilities to enhance your projects with accurate, up-to-date residential property insights.

Single Line Address Request

POST Request URL

https://api.addressverify.io/service/lookup/address
Run in Postman

Request Header Parameters:

ObjectDescription
x-api-key[Required] Your API access key, available in your account dashboard.

Request Body Parameters:

ObjectDescription
address[Required] The address to be verified.

Response Body Parameters:

ObjectTypeDescription
address[string]The full verified address.
addressValid[boolean]Whether the address is a residential property.
homeType[string]The type of property.
homeValue[int]The real-time estimated value of the property.

Example Success Response : 

{
  "address": "1013 Bates Ave, Bakersfield, CA, 93307",
  "addressValid": true,
  "homeType": "SINGLE_FAMILY",
  "homeValue": "273900"
}

Example Error Response : 

{
  "message": "Invalid address. Please include the street number",
  "error": "Bad Request",
  "statusCode": 400
}

Multi Line Address Request

POST Request URL

https://api.addressverify.io/service/lookup/fields
Run in Postman

Request Header Parameters:

ObjectDescription
x-api-key[Required] Your API access key, available in your account dashboard.

Request Body Parameters:

ObjectDescription
street[Required] The street number and name of the address.
city[Required] The city of the address.
state[Required] The state of the address.
zip[Required] The zip of the address.

Response Body Parameters:

ObjectTypeDescription
address[string]The full verified address.
addressValid[boolean]Whether the address is a residential property.
homeType[string]The type of property.
homeValue[int]The real-time estimated value of the property.

Example Success Response : 

{
  "address": "1013 Bates Ave, Bakersfield, CA, 93307",
  "addressValid": true,
  "homeType": "SINGLE_FAMILY",
  "homeValue": "273900"
}

Example Error Response : 

{
  "message": "Invalid address. Please include the street number",
  "error": "Bad Request",
  "statusCode": 400
}

Home Type List

APARTMENT
Apartment
CONDO
Condominium
LOT
Land Parcel
MANUFACTURED
Mobile Home
MULTI_FAMILY
Multi-Family Residence (Apartment|Condominium|Townhouse)
SINGLE_FAMILY
Single Family Residence
TOWNHOUSE
Townhouse
UNKNOWN
AddressVerify.io could not verify this property

Error Code List:

401UnauthorizedThe request requires user authentication.No user found with the provided credentials.User account is not active.Authentication token has expired.
402No active plans foundThe user has no active subscription plans.No active subscription plan found for this API.
404User not foundThe system could not find the requested user.
429Rate limit exceededThe user has sent too many requests in a given amount of time.The total request limit for the user has been exceeded.
400Bad requestThe request is missing a required email address or passwords.

Code Examples:

Highest Level of Compatibility

No need for a specific set of skills to parse data — our API functionality can be implemented in under 10 minutes using any major programming language.

example.php
<?php
$client = new Client();
$headers = [
  'x-api-key' => '{{apiKey}}'
];
$body = '{
    "address":"1013 Bates Ave, Bakersfield, CA, 93307"
}';
$request = new Request('POST', 'https://api.addressverify.io/service/lookup/address', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();