--- title: "MLS Search API" method: POST path: "/v2/MLSSearch" --- # MLS Search API `POST /v2/MLSSearch` Find property listings on-the-market that fit your specific criteria. ## Request body - object - `count` boolean — Enable "count" mode to only receive the number of results ("resultCount") matching your input payload, not the actual listing records. Default: false - `size` integer — Specify the number of results you'd like returned in your MLS Search API Call. Values of 1-250 accepted for record pulling mode (default). Values of 1-10,000 accepted for "ids_only": true mode. - `resultIndex` integer — "resultIndex" is your pagination parameter for MLS Search API. Each API call will a resultIndex value in the response you can use to fetch subsequent pages by adding it and its value in the input of the next request with the same query as before. - `listing_ids_only` boolean — return a list of all the listing IDs, with which you can hit MLS Detail (or MLS Detail Bulk) with to get additional info (max of 10,000 listing IDs per request) - `ids_only` boolean — Receive an array of RealEstateAPI unique "ID"s to assist with calling Property Detail or Property Detail Bulk API as your Step 2 to get public record data for your listing. Max size with ids_only mode is 10,000 - `include_photos` boolean — return full list of photos for each MLS Search response object, without having to call MLS Detail for each - `latest_only` boolean — use along with "active": true to eliminate closed listings still showing as active issue - `sort` object — for info on what is sortable: https://developer.realestateapi.com/reference/step-3-set-modes-search-settings#sort - `bathrooms` string - `bedrooms` string - `contract_date` string - `listing_date` string - `listing_price` string - `living_area` string - `lot_size` string - `modification_timestamp` string - `price_change` string - `sold_date` string - `sold_price` string - `year_built` string - `id` integer — "id" + "radius" will allow you to do a search radius search around a given property through it's RealEstateAPI ID - `listing_id` integer - `mls_number` string — Find a single listing by it's official MLS Number. Check here for a code sample: https://developer.realestateapi.com/reference/mls-number-search - `address` string — "address" can be used instead of "latitude"/"longitude" for search radius searches. Another use is to find any listing record matching for a specific address across different statuses (a previously sold, current active, etc.) - `house` string - `unit` string - `unit_type` string - `street` string — Filter for listings on a specific street - works best when combined with "city", "zip", "state", "county" - `city` string — Filter for listings in a specific city - required dependency is "state" field - `state` string — Accepts the 2 Character State Code, ALL CAPS. Filter for listings in a specific state - or combine with "county", "city" or "street" to narrow your search. - `zip` string — Filter for listings in a specific zip code or an array of zip codes - `county` string - `mls_board_code` string — Accepts a single "string" value or array of "string" values. MLS Board Codes for searching by specific boards can be provided by our team. - `latitude` number, float — Required dependency fields: "longitude", "radius" - `longitude` number, float — Required dependency fields: "latitude", "radius" - `radius` number, float — Use along with "latitude"/"longitude" to perform a search radius search around a specific location point with your other MLS Search filters applied. Values between 1-100 miles are accepted. - `polygon` object[] — Accepts an array of objects where each object consists of "lat"/"lon" fields. - `lat` number, float - `lon` number, float - `multi_polygon` unknown[] - unknown - `listing_property_type` 'RENTAL' | 'MANUFACTURED_IN_PARK' | 'COMMERCIAL_FOR_LEASE' | 'FARM' | 'RESIDENTIAL' | 'RESIDENTIAL_INCOME' | 'BUSINESS_OPPORTUNITY' | 'COMMERCIAL' | 'LAND' | 'RESIDENTIAL_LEASE' — Check possible values here: https://developer.realestateapi.com/reference/listing-property-type - `property_sub_type` string — Check possible values: https://developer.realestateapi.com/reference/property-sub-types - `property_type` string — SFR, MFR, LAND, CONDO, MOBILE, OTHER (from Public Record property types) - `active` boolean — Filter for listings with a status of "Active" - `cancelled` boolean — Filter for listings with a status of "Cancelled" - `failed` boolean — Filter for listings with a status of "Failed" - `pending` boolean — Filter for only pending listings - `sold` boolean — Please use "sold_date_min"/"sold_date_max" instead - `has_photos` boolean — Only return listings that have photos - `has_pool` boolean — A true/false flag that indicates whether the listed property has a pool - `has_basement` boolean — A true/false flag that indicates whether the listed property has a basement structure - `is_city_view` boolean — A true/false flag that indicates whether the listed property has a view of a city landscape - `is_mountain_view` boolean — A true/false flag that indicates whether the listed property has a view of a mountain - `is_park_view` boolean — A true/false flag that indicates whether the listed property has a view of a public park - `is_water_view` boolean — A true/false flag that indicates whether the listed property has a view of a pond, lake, river, or other body of water - `is_water_front` boolean — A true/false flag that indicates whether the listed property has direct access to a body of water - `custom_status` string - `status` string — Filter by the statuses of your choice: https://developer.realestateapi.com/reference/current-status-searches - `listing_agent_email` string — See examples of how to call for listings by listing agent email: https://developer.realestateapi.com/reference/search-for-agent-listings-by-email - `listing_agent_mls_code` string - `listing_agent_phone` string - `selling_agent_email` string — See examples of how to call for listings by selling agent email: https://developer.realestateapi.com/reference/search-for-agent-listings-by-email - `selling_agent_mls_code` string - `selling_agent_phone` string - `listing_office_email` string - `listing_office_mls_code` string - `listing_office_name` string - `listing_office_phone` string - `selling_office_email` string - `selling_office_mls_code` string - `selling_office_name` string - `selling_office_phone` string - `mls_type` string - `bathrooms` integer — Exact value bathroom count search param. Do NOT use along with "bathrooms_min"/"bathrooms_max" - `bathrooms_min` integer — Use along with "bathrooms_max" to search for listings with a range of bathrooms falling between your min & max - `bathrooms_max` integer — Use along with "bathrooms_min" to search for listings with a range of bathrooms falling between your min & max - `bedrooms` integer — Exact value bedroom count search param. Do NOT use along with "bedrooms_min"/"bedrooms_max" - `bedrooms_min` integer — Use along with "bedrooms_max" to search for listings with a range of bedrooms falling between your min & max - `bedrooms_max` integer — Use along with "bedrooms_min" to search for listings with a range of bathrooms falling between your min & max - `days_on_market_min` integer — Use along with "days_on_market_max" to search for listings with that have been on-market for the number of days falling between your min & max - `days_on_market_max` integer — Use along with "days_on_market_min" to search for listings with that have been on-market for the number of days falling between your min & max - `listing_price_min` integer — Use along with "listing_price_max" to search for listings with a current listing price range between your min & max - `listing_price_max` integer — Use along with "listing_price_min" to search for listings with a current listing price range between your min & max - `living_area` integer — Exact value living square feet search param. Do NOT use along with "living_area_min"/"living_area_max" - `living_area_min` integer — Use along with "living_area_max" to search for listings with a living square footage between your min & max - `living_area_max` integer — Use along with "living_area_min" to search for listings with a living square footage between your min & max - `lot_size` integer — Exact value lot square feet search param. Do NOT use along with "lot_size_min"/"lot_size_max" - `lot_size_min` integer — Use along with "lot_size_max" to search for listings with a lot square footage between your min & max - `lot_size_max` integer — Use along with "lot_size_min" to search for listings with a lot square footage between your min & max - `price_per_sqft_min` integer - `price_per_sqft_max` integer - `sold_price` integer — Exact value sold price search param. - `sold_price_min` integer - `sold_price_max` integer - `stories` integer — Exact value stories count search param. - `year_built` integer — Exact value year built search param. Useful for getting new construction - year_built: . Do NOT use along with "year_built_min"/"year_built_max" - `year_built_min` integer — Use along with "year_built_max" to search for listings with built in the years between your min & max - `year_built_max` integer — Use along with "year_built_min" to search for listings with built in the years between your min & max - `last_status_change_date_min` string, date — Check examples here: https://developer.realestateapi.com/reference/listing-status-change-date-searches - `last_status_change_date_max` string, date - `listing_date_min` string, date — YYYY-MM-DD date format - `listing_date_max` string, date — YYYY-MM-DD date format - `listing_contract_date_min` string, date - `listing_contract_date_max` string, date - `modification_timestamp_min` string, date — Filter for any listing changes with the modification timestamp search: https://developer.realestateapi.com/reference/listing-detail-update-searches - `modification_timestamp_max` string, date - `price_change_timestamp_min` string, date — Check examples here: https://developer.realestateapi.com/reference/listing-price-change-date-searches - `price_change_timestamp_max` string, date - `sold_date_min` string, date — Check code sample here: https://developer.realestateapi.com/reference/sold-date-searches - `sold_date_max` string, date - `listing_association_fee_min` integer - `listing_association_fee_max` integer - `exclude` object[] — currently only works with "listing_property_type" field, e.g. { exclude: [ {listing_property_type: "RENTAL" } ] } - `public_absentee_type` boolean — Filters against the public record data field: "absentee_owner" (bool) - `public_basement` boolean - `public_basement_type` 'FINISHED' | 'UNFINISHED' | 'PARTIALLY FINISHED' | 'NO BASEMENT' - `public_basement_square_feet_min` integer - `public_basement_square_feet_max` integer - `public_basement_sqft_finished_min` integer - `public_basement_sqft_finished_max` integer - `public_basement_sqft_unfinished_min` integer - `public_basement_sqft_unfinished_max` integer - `public_building_size_min` integer - `public_building_size_max` integer - `public_corporate_owned` boolean - `public_document_type` string — Filters against the County Tax Recorder data field that indicates the deed type of the current owner's mortgage. - `public_document_type_code` string — Filters against the public record deed type code corresponding with the corresponding mortgage document type descriptor: https://developer.realestateapi.com/reference/document-type-codes - `public_garage` boolean - `public_investor_buyer` boolean - `public_land_use` string — Filters against the County Assessor's classification for the listing parcel's land use. Common values include "Residential" and "Commercial" - `public_pool` boolean - `public_private_lender` boolean - `public_properties_owned_min` integer - `public_properties_owned_max` integer - `public_property_use` string - `public_property_use_code` integer — Accepts an integer or array of integers of the valid County Assessor classifications for property use that can be found here: https://developer.realestateapi.com/reference/property-use-codes-reference - `public_stories_min` integer - `public_stories_max` integer - `public_units_min` integer - `public_units_max` integer - `public_vacant` boolean - `public_years_owned_min` integer - `public_years_owned_max` integer ## Response `200` 200 - object - `listingId` integer, required — Unique identifier for the MLS listing - `id` string — Alternative identifier for the listing - `modificationTimestamp` string — Timestamp of when the listing was last modified - `listing` object, required — Core listing information and details - `courtesyOf` string — Courtesy information for the listing - `customStatus` string — Custom status field specific to the MLS board - `hasPhotos` boolean — Indicates whether the listing has associated photos - `internetAddressDisplayYN` boolean — Indicates whether the property address can be displayed on the internet - `isListed` boolean — Indicates if the property is currently listed - `listingAgentEmailAddress` string — Email address of the listing agent - `listingContractDate` string — Date when the listing contract was signed - `listPriceLow` integer — Lower bound of listing price range (if applicable) - `mlsNumber` string — MLS board-assigned listing number - `mlsBoardCode` string — Code identifying the specific MLS board - `pricePerSqFt` integer — Listing price per square foot - `priceChangeTimestamp` string — Timestamp of the most recent price change - `publicRemarks` string — Public-facing description and remarks about the listing - `sellingOfficeName` string — Name of the selling/listing office - `soldDate` string — Date when the property was sold - `standardStatus` string — Standardized listing status across all MLS boards - `url` string — URL to view the listing details - `address` object — Property address information - `city` string — City where the property is located - `countyOrParish` string — County or parish name - `stateOrProvince` string — State or province abbreviation - `unparsedAddress` string — Full address as a single string - `zipCode` string — ZIP or postal code - `leadTypes` object — MLS listing status and type indicators - `mlsActive` boolean — Indicates if the listing is currently active on MLS - `mlsCancelled` boolean — Indicates if the listing has been cancelled - `mlsDaysOnMarket` integer — Number of days the listing has been on the market - `mlsFailed` boolean — Indicates if the listing has a failed status - `mlsHasPhotos` boolean — Indicates whether the listing has photos available - `mlsLastStatusDate` string — Date when the listing status was last changed - `mlsListingDate` string — Date when the property was listed on MLS - `mlsListingPrice` integer — Current MLS listing price in USD - `mlsPending` boolean — Indicates if the listing is in pending status - `mlsSold` boolean — Indicates if the listing has been sold - `mlsStatus` string — Current MLS status of the listing - `mlsType` string — Type or classification of the MLS listing - `property` object — Core property characteristics and features - `associationFee` integer — Monthly or periodic HOA/association fee amount - `bathroomsText` string — Textual description of bathroom count - `bathroomsTotal` integer — Total number of bathrooms - `bedroomsTotal` integer — Total number of bedrooms - `garageSpaces` string — Number or description of garage parking spaces - `hasBasement` boolean — Indicates whether the property has a basement - `hasPool` boolean — Indicates whether the property has a swimming pool - `isCityView` boolean — Indicates whether the property has a city view - `isMountainView` boolean — Indicates whether the property has a mountain view - `isParkView` boolean — Indicates whether the property has a park view - `isWaterfront` boolean — Indicates whether the property is located on the waterfront - `isWaterview` boolean — Indicates whether the property has a water view - `latitude` integer — Geographic latitude coordinate of the property - `livingArea` integer — Living area size in square feet - `location` integer[] - `longitude` integer — Geographic longitude coordinate of the property - `lotSizeSquareFeet` integer — Total lot size in square feet - `neighborhood` string — Name of the neighborhood or subdivision where the property is located - `propertySubType` string — More specific classification of the property type - `propertyType` 'RENTAL' | 'MANUFACTURED_IN_PARK' | 'COMMERCIAL_FOR_LEASE' | 'FARM' | 'RESIDENTIAL' | 'RESIDENTIAL_INCOME' | 'BUSINESS_OPPORTUNITY' | 'COMMERCIAL' | 'LAND' | 'RESIDENTIAL_LEASE' — General category of the property - `stories` string — Number of stories/floors in the building - `subdivisionName` string — Name of the subdivision or planned community - `yearBuilt` integer — Year the property was originally constructed - `schools` object — Information about schools serving the property area - `elementarySchool` string — Name of the elementary school serving this area - `highSchool` string — Name of the high school serving this area - `middleOrJuniorSchool` string — Name of the middle or junior high school serving this area - `media` object — Media and photo information for the listing - `primaryListingImageUrl` string — URL of the primary/featured listing image - `photosCount` integer — Total number of photos available for the listing - `photosList` object[] — Array of photo objects with URLs and metadata - `listingAgent` object — Information about the listing agent representing the property - `email` string — Email address of the listing agent - `firstName` string — First name of the listing agent - `fullName` string — Full name of the listing agent - `lastName` string — Last name of the listing agent - `mlsAgentId` string — Unique MLS identifier for the listing agent - `mlsCode` string — MLS code associated with the listing agent - `phone` string — Phone number of the listing agent - `listingOffice` object — Information about the real estate office representing the listing - `address` string — Street address of the listing office - `city` string — City where the listing office is located - `email` string — Email address of the listing office - `mlsCode` string — MLS code for the listing office - `mlsOfficeId` string — Unique MLS identifier for the listing office - `name` string — Name of the listing office/brokerage - `phone` string — Phone number of the listing office - `postalCode` string — ZIP/postal code of the listing office - `stateOrProvince` string — State or province where the listing office is located - `websiteUrl` string — Website URL of the listing office - `sellingAgent` object — Information about the selling/buyer's agent in the transaction - `email` string — Email address of the selling agent - `firstName` string — First name of the selling agent - `fullName` string — Full name of the selling agent - `lastName` string — Last name of the selling agent - `mlsAgentId` string — Unique MLS identifier for the selling agent - `mlsCode` string — MLS code associated with the selling agent - `phone` string — Phone number of the selling agent - `sellingOffice` object — Information about the real estate office representing the buyer/selling side - `address` string — Street address of the selling office - `city` string — City where the selling office is located - `email` string — Email address of the selling office - `mlsCode` string — MLS code for the selling office - `mlsOfficeId` string — Unique MLS identifier for the selling office - `name` string — Name of the selling office/brokerage - `phone` string — Phone number of the selling office - `postalCode` string — ZIP/postal code of the selling office - `stateOrProvince` string — State or province where the selling office is located - `websiteUrl` string — Website URL of the selling office - `public` object — Public record and property data from county/assessor records - `absenteeType` string — Classification of absentee ownership status - `age` integer — Age of the property (current year minus year built) - `apn` string — Assessor's Parcel Number (unique property identifier) - `assessedImprovementValue` integer — Assessed value of improvements/buildings on the property - `assessedLandValue` integer — Assessed value of the land only - `assessedValue` integer — Total assessed value (land + improvements) for tax purposes - `auctionDate` string — Date of foreclosure auction (if applicable) - `bathrooms` integer — Number of bathrooms from public records - `bedrooms` integer — Number of bedrooms from public records - `companyName` string — Name of the company/entity that owns the property (if corporate-owned) - `deckArea` integer — Square footage of deck area - `documentType` string — Type of deed or transfer document - `documentTypeCode` string — Abbreviated code for the document type - `equity` integer — Estimated equity amount - `equityPercent` integer — Equity as a percentage of property value - `estimatedEquity` integer — Calculated estimated equity - `estimatedValue` integer — Estimated current market value of the property - `floodZoneDescription` string — Detailed description of the FEMA flood zone - `floodZoneType` string — FEMA flood zone designation code - `imageUrl` string — URL to a property image or street view - `landUse` string — Zoning or land use classification - `lastMortgage1Amount` integer — Original amount of the first mortgage - `lastSaleAmount` integer — Sale price from the most recent transaction - `lastSaleDate` string — Date of the most recent sale - `lastUpdateDate` string — Date when the public record data was last updated - `latitude` integer — Geographic latitude coordinate from public records - `lenderName` string — Name of the mortgage lender - `lienDocumentType` string — Type of lien document recorded against the property - `listingAmount` integer — Current or most recent listing price - `loanTypeCode` string — Type of loan/mortgage - `location` string — Array containing geographic coordinates - `longitude` integer — Geographic longitude coordinate from public records - `lotSquareFeet` integer — Lot size in square feet - `maturityDateFirst` string — Maturity date of the first mortgage - `medianIncome` integer — Median household income for the area - `neighborhood` string — Name of the neighborhood from public records - `noticeType` string — Type of foreclosure notice (if applicable) - `openMortgageBalance` integer — Current outstanding mortgage balance - `owner1FirstName` string — Last name of the primary property owner - `owner1LastName` string — Last name of the primary property owner - `owner2Company` string — Company name if second owner is a corporate entity - `owner2FirstName` string — First name of the second property owner - `owner2LastName` string — Last name of the second property owner - `parcelAccountNumber` string — Tax parcel account number - `patioArea` integer — Square footage of patio area - `poolArea` integer — Square footage of pool area - `portfolioPurchasedLast12Months` integer — Number of properties purchased by this owner in the last 12 months - `portfolioPurchasedLast6Months` integer — Number of properties purchased by this owner in the last 6 months - `pricePerSquareFoot` integer — Price per square foot calculation - `priorOwnerMonthsOwned` integer — Number of months the prior owner held the property - `priorSaleAmount` integer — Sale price of the previous transaction - `propertyId` string — Unique identifier for the property in the system - `propertyType` string — General property category from public records - `propertyUse` string — Textual description of property use - `propertyUseCode` string — Numeric or coded classification of property use - `recordingDate` string — Date the deed was recorded with the county - `rentAmount` integer — Monthly rental amount (if applicable) - `roomsCount` integer — Total number of rooms in the property - `squareFeet` integer — Total square footage of the property - `stories` integer — Number of stories/floors from public records - `suggestedRent` integer — Estimated market rent for the property - `taxDelinquentYear` integer — Year of tax delinquency (if applicable) - `taxType` string — Type or classification of property tax - `totalPortfolioEquity` integer — Combined equity across all properties owned by this owner - `totalPortfolioMortgageBalance` integer — Combined mortgage balance across all properties owned by this owner - `totalPortfolioValue` integer — Combined estimated value of all properties owned by this owner - `totalPropertiesOwned` integer — Total number of properties owned by this owner - `unitsCount` integer — Number of rental units (for multi-family properties) - `yearBuilt` integer — Year the property was constructed from public records - `yearsOwned` integer — Number of years the current owner has held the property - `basementFinishedPercent` integer — Percentage of basement that is finished - `basementSquareFeet` integer — Total basement square footage - `basementSquareFeetFinished` integer — Finished basement square footage - `basementSquareFeetUnFinished` integer — Unfinished basement square footage - `basementType` string — Type or classification of basement - `livingSquareFeet` integer — Living area square footage (excluding garage, basement, etc.) - `leadTypes` object - `absenteeOwner` boolean — Indicates if the property owner lives elsewhere (not owner-occupied) - `adjustableRate` boolean — Indicates if the property has an adjustable rate mortgage (ARM) - `airConditioningAvailable` boolean — Indicates if the property has air conditioning - `assumable` boolean — Indicates if the mortgage is assumable by a buyer - `auction` boolean — Indicates if the property is scheduled for auction - `basement` boolean — Indicates if the property has a basement - `cashBuyer` boolean — Indicates if the property was purchased with cash (no financing) - `corporateOwned` boolean — Indicates if the property is owned by a corporation or business entity - `death` boolean — Indicates if a death of an owner has been recorded - `deck` boolean - `floodZone` boolean — Indicates if the property is located in a FEMA-designated flood zone - `foreclosure` boolean — Indicates if the property is in foreclosure - `forSale` boolean — Indicates if the property is currently listed for sale - `freeClear` boolean — Indicates if the property has no mortgage or liens (owned free and clear) - `garage` boolean — Indicates if the property has a garage - `highEquity` boolean — Indicates if the property has high equity (typically >50%) - `inherited` boolean — Indicates if the property was inherited by current owner - `inStateAbsenteeOwner` boolean — Indicates if the owner lives in the same state but not at the property - `investorBuyer` boolean — Indicates if the property was purchased by an investor - `judgment` string — Indicates if there is a judgment recorded against the property - `MFH2to4` boolean — Indicates if the property is a multi-family home with 2-4 units - `MFH5plus` boolean — Indicates if the property is a multi-family home with 5 or more units - `negativeEquity` boolean — Indicates if the property has negative equity (underwater mortgage) - `outOfStateAbsenteeOwner` boolean — Indicates if the owner lives in a different state than the property - `ownerOccupied` boolean — Indicates if the owner lives at the property - `patio` boolean — Indicates if the property has a patio - `pool` boolean — Indicates if the property has a swimming pool - `preForeclosure` boolean — Indicates if the property is in pre-foreclosure status (notice filed) - `priorOwnerIndividual` boolean — Indicates if the previous owner was an individual (not corporate) - `privateLender` boolean — Indicates if the property is financed by a private or hard money lender - `reo` boolean — Indicates if the property is Real Estate Owned (bank-owned/foreclosed) - `vacant` boolean — Indicates if the property is currently vacant/unoccupied - `address` object — Property address from public records - `address` string — Full formatted address string - `street` string — Street address line - `city` string — City name - `county` string — County name - `state` string — State abbreviation - `zip` string — ZIP or postal code - `label` string — Address label or formatted description - `mailAddress` object — Mailing address for the property owner (where owner receives mail) - `address` string — Full formatted mailing address string - `street` string — Street address line for mailing - `city` string — City name for mailing address - `county` string — County name for mailing address - `state` string — State abbreviation for mailing address - `zip` string — ZIP or postal code for mailing address - `label` string — Mailing address label or formatted description ## Other responses - `400` — 400 --- [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)