# Property Comparables Analysis

**POST /v3/PropertyComps**

Find comparable properties for valuation and analysis purposes.
Includes advanced filtering and market analysis features.



## Servers
- Production server: https://api.realestateapi.com (Production server)


## Authentication methods
- Api key


## Parameters
### Headers
- **x-api-key** (string)
  API key for authentication
- **x-user-id** (string)
  Optional user identifier for tracking and analytics



### Body: application/json (object)
Property comparables request
- **id** (string | integer)
  Unique property identifier to find comps for
- **address** (string)
  Full property address
- **apn** (string)
  Assessor's Parcel Number
- **lat** (number)
  Property latitude
- **lon** (number)
  Property longitude
- **radius** (number)
  Search radius in miles for finding comps
- **comp_count** (integer)
  Number of comparable properties to return
- **bedrooms** (integer)
  Number of bedrooms for filtering
- **bathrooms** (number)
  Number of bathrooms for filtering
- **sqft_min** (integer)
  Minimum square footage for comps
- **sqft_max** (integer)
  Maximum square footage for comps
- **property_type** (array[string])
  Property types to include in comps
- **sale_date_min** (string(date))
  Minimum sale date for comparable properties
- **sale_date_max** (string(date))
  Maximum sale date for comparable properties


## Responses
### 200
Successful response with comparable properties

#### Body: application/json (object)
- **input** (object)
  Echo of the input parameters
- **subject_property** (object)
  Details of the subject property
- **data** (array[object])
  Array of comparable properties
- **analysis** (object)
  Comparative market analysis
- **totalResults** (integer)
  Total comparable properties found
- **returnedResults** (integer)
  Number of comps returned
- **statusCode** (integer)
  HTTP status code
- **live** (boolean)
  Indicates if data is live

### 400
Bad Request - Invalid input parameters

#### Body: application/json (object)
- **error** (string)

- **message** (string)

- **statusCode** (integer)

- **details** (object)
  Additional error details

### 401
Unauthorized - Invalid or missing API key

#### Body: application/json (object)
- **error** (string)

- **message** (string)

- **statusCode** (integer)


### 404
Not Found - Resource not found

#### Body: application/json (object)
- **error** (string)

- **message** (string)

- **statusCode** (integer)


### 500
Internal Server Error

#### Body: application/json (object)
- **error** (string)

- **message** (string)

- **statusCode** (integer)



[Powered by Bump.sh](https://bump.sh)