Endpoint to verify if a user is the owner of an address

The Homeowner Verification API allows you to verify a user's ownership status of a specific property. By using the proprietary owner verification function, this API employs a sophisticated matching algorithm to cross-reference the property deed and other records, determining the likelihood that the user owns the home.

Endpoint

The endpoint for accessing the Homeowner Verification API is:

POST https://api.chimney.io/api/v1/homeowner/verify

Request Body

The API request should include the following in the request body:

  • Content-Type: application/json

The request body should include the following fields:

  • firstName (string, required): The first name of the homeowner.
  • lastName (string, required): The last name of the homeowner.
  • address (string, required): The full address of the property, including the street, city, state, and ZIP code.

Example:

{
  "firstName": "John",
  "lastName": "Doe",
  "address": "123 Main St, Anytown, NY 12345",
  "ownerID": 12345658
}

Response

The API provides a sample response with the following structure:

  • Owner Verification

    • isVerified (boolean): Indicates whether the ownership is verified.
    • matchScore (float): The matching score indicating the likelihood of ownership.
    • ownerOccupied (boolean): Indicates if the property is owner-occupied.
    • propertyType (string): The type of the property (e.g., residential).
    • corporation (boolean): Indicates if the property is owned by a corporation.
  • Owner Names

    • owner (object): Information about the owner (max of 4 owners).
      • lastname (string): The last name of the owner.
      • firstnameandmi (string): The first name and middle initial of the owner.

Example:

{
  "Owner Verification": {
    "ownerID": 12345658,
    "isVerified": true,
    "matchScore": 0.9,
    "ownerOccupied": true,
    "propertyType": "residential",
    "corporation": false
  },
  "Owner Names": {
    "owner1": {
      "lastname": "Doe",
      "firstnameandmi": "John"
    },
    "owner2": {},
    "owner3": {},
    "owner4": {}
  }
}

The response contains information about the verification result, including whether the ownership is verified (isVerified), the matching score (matchScore), whether the property is owner-occupied (ownerOccupied), and the property type (propertyType). Additionally, it provides owner name details for up to four owners.

Example Usage

Here's an example of how to make a POST request to the Homeowner Verification API endpoint:

curl --request POST \
  --url https://api.chimney.io/api/v1/homeowner/verify \
  --header 'Content-Type: application/json' \
  --data '{
    "firstName": "John",
    "lastName": "Doe",
    "address": "123 Main St, Anytown, NY 12345"
  }'

Replace the "firstName", "lastName", and "address" values with the actual homeowner information and property address for verification.

Conclusion

The Homeowner Verification API provided by Chimney allows you to verify a user's ownership status of a specific property. By making a POST request to the /homeowner/verify endpoint and providing the required homeowner and property address information, you can receive a response with the verification result and additional details about the property.