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.


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.


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


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.


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


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.