--- title: "MLS Detail API (legacy)" method: POST path: "/v2/MLSDetail" deprecated: true --- # MLS Detail API (legacy) `POST /v2/MLSDetail` ## Request - Base URL: `https://api.realestateapi.com` - URL: `https://api.realestateapi.com/v2/MLSDetail` - Auth: API key in header `x-api-key` > **Deprecated.** Get the Official MLS Listing Data for a specific Property - using a "listing_id" or an "address" ## Request body - object - `listing_id` integer: provide the "listingId" from the MLS Search response object - `id` integer: provide a REAPI "id" from the MLS Search response object (NOTE: not all listings will have a public record "id") - `address` string: provide a fully formatted address to retrieve the most recent listing info for it - `house` string - `unit` string - `unit_type` string - `street` string - `city` string - `state` string - `zip` string - `county` string - `mls_number` string: since not all MLS numbers are unique, please provide along with mls_board_code - `mls_board_code` string: helps resolve specific MLS numbers when there is a duplicate in different MLS board regions ## Response `200` 200 - object - `data` object, required: Contains the MLS listing detail information - `listingId` integer, required - `reapid` string: REAP (Real Estate API) identifier - `courtesyOf` string: Courtesy information for the listing - `customStatus` string: Custom status field specific to the MLS board - `daysOnMarket` integer: Number of days the listing has been on the market - `standardStatus` string: Standardized listing status across all MLS boards - `hasPhotos` boolean: Indicates whether the listing has associated photos - `isListed` string: Indicates if the property is currently listed - `listingAgentEmailAddress` string: Email address of the listing agent - `listingContractDate` string: Date when the listing contract was signed - `listPrice` string: Current listing price - `mlsNumber` string: MLS board-assigned listing number - `mlsBoardCode` string: Code identifying the specific MLS board - `modificationTimestamp` string: Timestamp of when the listing was last modified - `priceChangeTimestamp` string: Timestamp of the most recent price change - `pricePerSqFt` integer: Listing price per square foot - `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 - `url` string: URL to view the listing details - `homedetails` object: Detailed information about the property's features and characteristics - `appliances` string[]: Frequency of HOA/association fee payments (e.g., Monthly, Annually, Quarterly) - `associationFeeFrequency` string: Frequency of HOA/association fee payments (e.g., Monthly, Annually, Quarterly) - `cooling` string: Type of cooling system(s) available in the property - `directions` string: Driving directions to the property - `exteriorFeatures` integer: Description of exterior features and amenities - `fireplacesTotal` integer: Total number of fireplaces in the property - `fireplaceYn` boolean: Indicates whether the property has a fireplace - `flooring` string: Types of flooring materials in the property - `heating` string: Type of heating system(s) in the property - `lotFeatures` integer: Features and characteristics of the lot/land - `lotSizeAcres` integer: Lot size in acres - `lotSizeArea` integer: Lot size in square feet - `roof` string: Type of roof material and construction - `sewer` string: Type of sewer system - `taxAmount` integer: Annual property tax amount - `watersource` string: Source of water for the property - `zoning` string: Property zoning classification - `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 (not parsed into components) - `zipCode` string: ZIP or postal code - `property` object: Core property characteristics and features - `associationFee` integer: Monthly or periodic HOA/association fee amount - `bathroomsText` string: Textual description of bathroom count (may include fractional bathrooms) - `bathroomsHalf` integer: Number of half bathrooms (toilet + sink, no shower/tub) - `bathroomsTotal` integer: Total number of bathrooms (full + half combined) - `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 from public records - `lotSizeSquareFeet` integer: Lot size in square feet from public records - `neighborhood` string: Name of the neighborhood from public records - `propertySubType` string: Specific property classification from public records - `propertyType` string: General property category from public records - `stories` string: Number of stories/floors from public records - `subdivisionName` string: Name of the subdivision from public records - `yearBuilt` integer: Year the property was constructed from public records - `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 - `schoolDistrict` string: Name of the school district - `media` object: Media and photo information for the listing - `primaryListingImageUrl` string: URL of the primary/featured listing image - `photosCount` string: Total number of photos available for the listing - `photosList` object[]: Array of photo objects with URLs at different resolutions - `lowRes` string: URL for low-resolution version of the photo (300px width) - `midRes` string: URL for medium-resolution version of the photo (900px width) - `highRes` string: URL for high-resolution/full-size version of the photo - `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 - `openHouses` object: Array of scheduled open house events for the property - `openHouseDate` string: Date of the open house event - `openHouseStatus` string: Status of the open house event - `openHouseType` string: Type or format of the open house - `officeMLSId` string: MLS identifier for the office hosting the open house - `memberMLSId` string: MLS identifier for the agent/member hosting the open house - `openHouseRemarks` string: Additional notes or instructions about the open house - `updatedAt` string: Timestamp of when the open house information was last updated - `directions` string: Directions or instructions for finding/attending the open house - `openHouseEndTime` string: End time of the open house event - `openHouseStartTime` string: Start time of the open house event - `refreshments` string: Information about refreshments available at the open house - `openHouseModificationTimestamp` string: Timestamp of when the open house record was last modified ## Other responses - `400`: 400 --- [API](https://skmtc.dev/realestateapi/apis/mls-apis.md) - [All operations](https://skmtc.dev/realestateapi/apis/mls-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/realestateapi/apis/mls-apis/revisions/18336ae63b9a?raw)