---
title: "Value by Image"
method: POST
path: "/v3/property/value_by_image"
tags: ["Property Level"]
---

# Value by Image

`POST /v3/property/value_by_image`

This set of endpoints returns property value estimates based on submitted property images. Up to 20 images are accepted per request and a larger set of images will yield more accurate results. First, submit property images and an address to the POST value_by_image endpoint to receive a job_id and block_group_id. Then poll the GET value_by_image_job endpoint, passing the returned job_id and block_group_id, until job completion. When the job has finished, the property’s adjusted condition score and conditioned-based AVM (Automated Valuation Model) and FSD will be returned. Note: please do not poll the GET value_by_image_job endpoint more frequently than once per second to avoid interruptions from our firewall. 

Source: HouseCanary 

Pricing Tier: Premium Plus 

Updated: Annually

## Request Body Fields

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr>
<tr><td>address</td><td>string</td><td>JSON-encoded address object</td><td>{"slug":null,"city":"Gilbert","state":"AZ","unit":"","address":"1624 E Dogwood Ln","zipcode":"85295"}</td>
        </tr>
<tr><td>images</td><td>array</td><td>Up to 20 images are accepted per request and a larger set of images will yield more accurate results.</td><td></td>
        </tr>
<tr><td>images[]</td><td>string</td><td>Binary image data</td><td>file</td>
        </tr>
</table>

## Response

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr>
<tr><td>message</td><td>string</td><td>The operation's status message</td><td>Job submitted</td>
        </tr>
<tr><td>job_id</td><td>string</td><td>The identifier of the job</td><td>11848</td>
        </tr>
<tr><td>job_status_url</td><td>string</td><td>The URL to be used for checking the job status</td><td>/property/value_by_image_job/11848?block_group_id=040138155022&slug=1624-E-Dogwood-Ln-Gilbert-AZ-85295</td>
        </tr>
</table>

## Response `200`

Success

- object
  - `message` string, required — The operation's status message
  - `job_id` string, required — The identifier of the job
  - `job_status_url` string, required — The URL to be used for checking the job status

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Address not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis.md) · [All operations](https://skmtc.net/housecanary/apis/housecanary-analytics-and-portfolio-monitoring-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/housecanary/housecanary-analytics-and-portfolio-monitoring-apis/revisions/38afb6724de7/schema)