---
title: "/v3/PropertyComps API"
method: POST
path: "/v3/PropertyComps"
---

# /v3/PropertyComps API

`POST /v3/PropertyComps`

Customize your comps model

## Request body

- object
  - `id` string — Property ID for subject property
  - `address` string — The fully formatted address for your subject property (e.g. 123 Main St, Arlington, VA 22205)
  - `exact_match` boolean — Enforces strictness on the address matching. No fuzzy matching.
  - `max_radius_miles` number, float — Accepts values 0.1 to 100.
  - `max_days_back` integer — Specify 30 (days), 60 (days), 90 (days), etc. range for the recent sales comps that are returned.
  - `max_results` integer — Cap the amount of comps you want returned and how contribute to your AVM calculation.
  - `arms_length` boolean
  - `same_baths` boolean — If true, all comps returned will have the same number of bathrooms
  - `same_beds` boolean — If true, all comps returned will have the same number of bedrooms
  - `same_census_tract` boolean — If true, all comps returned will reside inside the same census tract
  - `same_county` boolean — If true, all comps returned will reside in the same county
  - `same_neighborhood` boolean — If true, all comps returned will reside in the same neighborhood
  - `same_zip` boolean — If true, all comps returned will reside in the same zipcode
  - `last_sale_price_min` integer
  - `last_sale_price_max` integer
  - `mls_listing_price_min` integer
  - `mls_listing_price_max` integer
  - `bathrooms_min` integer — Set a range for the number of bathrooms in the house, so that comps returned match those specs
  - `bathrooms_max` integer
  - `bathrooms_boost` integer — Accepts values 1 to 50.
  - `bedrooms_min` integer — Set a range for the number of bedrooms in the house, so that comps returned match those specs
  - `bedrooms_max` integer
  - `bedrooms_boost` integer — Accepts values 1 to 50.
  - `living_square_feet_min` integer — Set a range for the square feet of the property, so that comps returned match the size specifications
  - `living_square_feet_max` integer
  - `living_square_feet_boost` integer — Accepts values 1 to 50.
  - `lot_square_feet_min` integer — Set a range for the square feet of the lot, so that comps returned match the size specifications
  - `lot_square_feet_max` integer
  - `lot_square_feet_boost` integer — Accepts values 1 to 50.
  - `year_built_min` integer — Set a range for the year your comparable properties were built
  - `year_built_max` integer
  - `year_built_boost` integer — Accepts values 1 to 50.
  - `same_construction_type` boolean — If the subject property has a populated construction type, will only return comps with that same type when set to true

## Response `200`

200

- object
  - `subject` object, required — Detailed information about the subject property being analyzed
    - `id` string — Unique identifier for the subject property
    - `propertyInfo` object — Physical characteristics and details of the property
      - `address` object — Property address components
        - `fips` string — Federal Information Processing Standards code for the county
        - `house` string — House/building number
        - `address` string — Full street address
        - `street` string — Street name without number or type
        - `preDirection` string — Street directional prefix
        - `streetType` string — Street type suffix
        - `unit` string — Unit/apartment number
        - `unitType` string — Unit type designation
        - `city` string — City name
        - `county` string — County name
        - `state` string — State abbreviation
        - `zip` string — 5-digit ZIP code
        - `zip4` string — 4-digit ZIP code extension
        - `congressionalDistrict` string — Congressional district number
        - `label` string — Formatted full address label
      - `bedrooms` integer — Number of bedrooms
      - `bathrooms` integer — Number of bathrooms
      - `yearBuilt` integer — Year the property was constructed
      - `livingSquareFeet` integer — Living area square footage
      - `lotSquareFeet` integer — Lot size in square feet
      - `latitude` integer — Geographic latitude coordinate
      - `longitude` integer — Geographic longitude coordinate
      - `garageType` string — Type of garage
      - `airConditioningType` string — Type of air conditioning system
    - `lotInfo` object — Lot and parcel information
      - `apn` string — Assessor's Parcel Number (formatted)
      - `apnUnformatted` string — Assessor's Parcel Number without formatting
      - `lotNumber` string — Lot number from property records
      - `landUse` string — Land use classification
      - `propertyType` string — Property type classification
      - `zoning` string — Zoning classification
      - `censusTract` string — Census tract identifier
      - `lotDepthFeet` integer — Lot depth in feet
      - `lotWidthFeet` integer — Lot width in feet
    - `ownerInfo` object — Property owner information
      - `owner1FirstName` string — First name of the primary property owner
      - `owner1LastName` string — Last name of the primary property owner
      - `owner2FirstName` string — First name of the second property owner
      - `owner2LastName` string — Last name of the second property owner
      - `companyName` string — Company name if the property is corporate-owned
      - `mailAddress` object — Mailing address for the property owner
        - `fips` string — Federal Information Processing Standards code for the mailing address county
        - `house` string — House/building number for mailing address
        - `address` string — Full mailing street address
        - `street` string — Street name for mailing address
        - `preDirection` string — Street directional prefix for mailing address
        - `streetType` string — Street type suffix for mailing address
        - `unit` string — Unit/apartment number for mailing address
        - `unitType` string — Unit type designation for mailing address
        - `city` string — City name for mailing address
        - `county` string — County name for mailing address
        - `state` string — State abbreviation for mailing address
        - `zip` string — 5-digit ZIP code for mailing address
        - `zip4` string — 4-digit ZIP code extension for mailing address
        - `carrierRoute` string — USPS carrier route code for mailing address
        - `addressFormat` string — Format classification of the mailing address
        - `label` string — Formatted full mailing address label
    - `taxInfo` object — Tax assessment and valuation information
      - `taxAmount` string — Annual property tax amount
      - `assessedValue` string — Total assessed value for tax purposes
      - `marketValue` string — Market value assessment
    - `schools` object[] — Array of schools serving the property area
      - `rating` string — School rating or score
      - `name` string — Name of the school
      - `type` string — Type of school
    - `propertyType` string — Type/classification of the property
    - `vacant` boolean — Type/classification of the property
    - `absenteeType` string — Type of absentee ownership
    - `absenteeOwner` boolean — Indicates if the owner does not live at the property
    - `corporateOwned` boolean — Indicates if the property is owned by a corporation or business
    - `outOfStateAbsenteeOwner` boolean — Indicates if the owner lives out of state
    - `inStateAbsenteeOwner` boolean — Indicates if the owner lives in-state but not at the property
    - `estimatedValue` integer — Estimated current market value of the property
    - `estimatedEquity` integer — Estimated equity (estimated value minus mortgage balance)
    - `equityPercent` integer — Equity as a percentage of property value
    - `openMortgageBalance` integer — Current outstanding mortgage balance
    - `estimatedMortgageBalance` integer — Estimated current mortgage balance
    - `lastSaleDate` string — Date of the most recent sale
    - `lastSalePrice` integer — Sale price from the most recent transaction
    - `mlsListingAmount` integer — Current or most recent MLS listing price
    - `mlsListingDate` string — Date when the property was listed on MLS
    - `mlsLastStatusDate` string — Date of the most recent MLS status change
    - `mlsLastSaleDate` string — Date when the property sold according to MLS records
    - `mlsSoldPrice` integer — MLS sold price
    - `daysOnMarket` integer — Number of days the property was/has been on the market
    - `bankruptcyChapter` string — Bankruptcy chapter if applicable
    - `preForeclosure` boolean — Indicates if the property is in pre-foreclosure status
    - `cashBuyer` boolean — Indicates if the property was purchased with cash (no financing)
    - `privateLender` boolean — Indicates if the property is financed by a private or hard money lender
    - `currentOwner` boolean — Indicates if this record represents the current owner
    - `amountEstimated` boolean — Indicates if financial amounts are estimated rather than actual
    - `pricePerSquareFoot` integer — Price per square foot calculation
    - `mortgageHistory` object[] — Array of historical mortgage records for the property
      - `lenderName` string — Name of the mortgage lender
  - `comps` object[] — Array of comparable properties similar to the subject property
    - `id` string — Unique identifier for the comparable property
    - `distance` integer — Distance from the subject property in miles
    - `priorId` string — Previous identifier for the property
    - `vacant` boolean — Indicates if the comparable property is vacant
    - `absenteeType` string — Type of absentee ownership for the comparable
    - `absenteeOwner` boolean — Indicates if the owner does not live at the comparable property
    - `corporateOwned` boolean — Indicates if the comparable is corporate-owned
    - `outOfStateAbsenteeOwner` boolean — Indicates if the owner lives out of state
    - `inStateAbsenteeOwner` boolean — Indicates if the owner lives in-state but not at the property
    - `bedrooms` integer — Number of bedrooms
    - `bathrooms` integer — Number of bathrooms
    - `daysOnMarket` integer — Number of days on the market
    - `bankruptcyChapter` string — Bankruptcy chapter if applicable
    - `yearBuilt` integer — Year the comparable property was built
    - `squareFeet` integer — Total square footage
    - `estimatedValue` integer — Estimated market value
    - `estimatedEquity` integer — Estimated equity
    - `equityPercent` integer — Equity as a percentage
    - `openMortgageBalance` integer — Current outstanding mortgage balance
    - `estimatedMortgageBalance` integer — Estimated mortgage balance
    - `lastSaleDate` string — Date of the most recent sale
    - `lastSaleAmount` integer — Sale amount from the most recent transaction
    - `mlsListingAmount` integer — MLS listing price
    - `mlsListingDate` string — MLS listing date
    - `mlsLastStatusDate` string — MLS last status change date
    - `mlsLastSaleDate` string — MLS sale date
    - `mlsSoldPrice` integer — MLS sold price
    - `lotSquareFeet` integer — Lot size in square feet
    - `latitude` integer — Geographic latitude coordinate
    - `longitude` integer — Geographic longitude coordinate
    - `apn` string — Assessor's Parcel Number (formatted)
    - `apnUnformatted` string — Assessor's Parcel Number (unformatted)
    - `fips` string — FIPS county code
    - `landUse` string — Land use classification
    - `propertyType` string — Property type
    - `owner1FirstName` string — First name of primary owner
    - `owner1LastName` string — Last name of primary owner
    - `owner2FirstName` string — First name of second owner
    - `owner2LastName` string — Last name of second owner
    - `companyName` string — Company name if corporate-owned
    - `taxAmount` integer — Annual property tax amount
    - `taxAssessedValue` integer — Tax assessed value
    - `garageAvailable` boolean — Indicates if garage is available
    - `airConditioningAvailable` boolean — Indicates if air conditioning is available
    - `preForeclosure` boolean — Indicates if in pre-foreclosure
    - `cashBuyer` boolean — Indicates if purchased with cash
    - `privateLender` boolean — Indicates if financed by private lender
    - `currentOwner` boolean — Indicates if current owner
    - `amountEstimated` boolean — Indicates if amounts are estimated
    - `zoning` string — Zoning classification
    - `censusTract` string — Census tract identifier
    - `congressionalDistrict` string — Congressional district number
    - `lenderName` string — Name of the mortgage lender
    - `address` object — Property address for the comparable
      - `zip` string — 5-digit ZIP code
      - `city` string — City name
      - `county` string — County name
      - `state` string — State abbreviation
      - `street` string — Street address
      - `address` string — Full formatted address
    - `mailAddress` object — Mailing address for the comparable property owner
      - `zip` string — 5-digit ZIP code for mailing address
      - `city` string — City name for mailing address
      - `county` string — County name for mailing address
      - `state` string — State abbreviation for mailing address
      - `street` string — Street address for mailing
      - `address` string — Full formatted mailing address
    - `age` integer — Age of the comparable property (current year minus year built)
    - `pricePerSquareFoot` integer — Price per square foot calculation

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/realestateapi/apis/property-apis.md) · [All operations](https://skmtc.net/realestateapi/apis/property-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/realestateapi/property-apis/versions/8e1eee264b55/schema)
