The Chimney Estimate Endpoint provides a home valuation Automated Valuation Model (AVM) for estimating the value of a property. This AVM model specializes in providing accurate valuations based on the property's address. The API requires the following input:

Please be sure to follow our branding requirements when using the Chimney Estimate

Endpoint

The endpoint for accessing the Chimney Estimate AVM API is:

POST https://api.chimney.io/api/v1/avm

Request Body

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

  • Content-Type: application/json

The request body should include the following field:

  • address (string, required): The address of the property for which the valuation is needed.

Example:

{
  "address": "123 Main St, Anytown, NY 12345"
}

Responses

The API provides a sample response in the following structure:

{
  "Chimney Estimate": {
    "eventDate": "2023-05-24",
    "amount": {
      "scr": 98,
      "value": 741016,
      "high": 755836,
      "low": 726195,
      "valueRange": 14820
    },
    "AVMChange": {
      "avmlastmonthvalue": 737918,
      "avmamountchange": 3098,
      "avmpercentchange": 0
    },
    "conditionRange": {
      "avmpoorlow": 689885.25,
      "avmpoorhigh": 718044.2,
      "avmgoodlow": 726195,
      "avmgoodhigh": 755836,
      "avmexcellentlow": 744349.87,
      "avmexcellenthigh": 774731.9,
    }
}

The response contains various details regarding the estimated value and condition of the property based on the provided address.

Example Usage

Here's an example of how to make a POST request to the Chimney Estimate AVM API endpoint:

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

Replace the "address" value with the actual address for which you want to obtain the valuation.

Conclusion

The Chimney Estimate AVM API allows you to estimate the value of a property based on its address. By making a POST request to the /avm endpoint and providing the required address information, you can receive a detailed response with the estimated value, range, and condition scores of the property.