API Documentation

Address Lookup

Our Address Lookup API validates residential addresses and provides detailed information about the property type and estimated value.

Single Line Address Request

POST Request URL

https://api.addressverify.io/service/lookup/address

Request Header Parameters:

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

Request Body Parameters:

Object	Description
address	[Required] The address to be verified.

Response Body Parameters:

Object	Type	Description
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

Request Header Parameters:

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

Request Body Parameters:

Object	Description
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:

Object	Type	Description
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
}

Single Line Address Request

Submit a complete address in a single line for quick verification. The API will parse and validate the address components automatically.

Multi Line Address Request

Submit address components separately for more precise validation. This method allows you to specify street, city, state, and zip code individually.

Home Type List

Error Code List

Code Examples

<?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();