--- title: "MLS Detail API" method: POST path: "/v2/MLSDetail" --- # MLS Detail API `POST /v2/MLSDetail` 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.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)