Understanding the data in a listings' response
Overview
This document describes each top-level record in the listings' API JSON response, what type it is (simple field, object, or array), and includes information about its purpose, alongside a generic example.
Contents
mlsNumber
Type: field (string)
Purpose: Represents the unique MLS® identifier string for this specific listing within the board.
Example:
"mlsNumber": "MRFO6274516"
resource
Type: field (string)
Purpose: Identifies the internal Repliers underlying MLS® resource feed.
Example:
"resource": "Property:2505"
status
Type: field (string)
Purpose: Current listing status code indicating the property's availability on the market.
Possible Values: "A" (Active), "U" (Unavailable)
Related articles:
https://help.repliers.com/en/article/filtering-listings-by-status-16fc4yd/
Example:
"status": "A"
class
Type: field (string).
Purpose: Indicates the high-level property class, such as condo, commercial or residential. This also determines, in part, the schema of the listing. For a condo class property, the object "condominium" will be included. For a commercial property, the object "commercial" will be included.
Possible Values: "ResidentialProperty", "CondoProperty", "CommercialProperty"
Example:
"class": "CondoProperty"
type
Type: field (string)
Purpose: Indicates the transaction type for the listing, such as sale or lease.
Possible Values: "Sale","Lease"
Example:
"type": "Lease"
listPrice
Type: field (integer)
Purpose: Holds the current asking price for the listing as it is actively being marketed.
Example:
"listPrice": 2000
listDate
Type: field (string, date-time)
Purpose: Represents the date and time when the listing was placed on the market in the MLS® system.
Example:
"listDate": "2025-09-12T00:00:00.000-00:00"
lastStatus
Type: field (string)
Purpose: Provides the most recent MLS® status for the listing.
Possible values: "New" (New), "Sc" (Sold Conditionally), "Pc" (Price Change), "Ext" (Extension), "Lc" (Leased Conditionally), "Cs" (Coming Soon), "Sce" (Sold Conditionally with Escape Clause), "Sld" (Sold), "Ter" (Terminated), "Exp" (Expired), "Inc" (Incomplete), "Dft" (Deal Fell Through), "Lce" (Leased Conditionally with Escape Clause), "Sus" (Suspended)
Related articles:
https://help.repliers.com/en/article/laststatus-definitions-8mokhu/
Example:
"lastStatus": "New"
soldPrice
Type: field (integer)
Purpose: Stores the final recorded sale price for the property when the listing has closed.
Example:
"soldPrice": 325000
soldDate
Type: field (string)
Purpose: Stores the date and time when the sale transaction for the listing was completed.
Example:
"soldDate": "listDate": "2025-11-12T00:00:00.000-00:00"
originalPrice
Type: field (integer)
Purpose: Captures the initial asking price when the listing first went on the market.
Example:
"originalPrice": 2000
assignment
Type: field (String)
Purpose: Indicates whether the listing is an assignment-type deal or holds related assignment details where applicable.
Possible values: "Y","N",null
Example:
"assignment": "N"
address
Type: object
Purpose: Encapsulates the structured civic address of the property, including municipality, neighborhood, street components, unit, and postal code.
Example:
"address": {
"area": "Orange",
"city": "ORLANDO",
"country": "US",
"district": null,
"majorIntersection": null,
"neighborhood": "BELLA TERRA",
"streetDirection": null,
"streetName": "MAITLAND CROSSING",
"streetNumber": "2717",
"streetSuffix": "WAY",
"unitNumber": "207",
"zip": "32810",
"state": "FL",
"communityCode": null,
"streetDirectionPrefix": null,
"addressKey": "2072717maitlandcrossingwayorlando"
}
map
Type: object
Purpose: Contains geospatial information for the property, including latitude, longitude, and a point representation for spatial queries.
Example:
"map": {
"latitude": 28.63679,
"longitude": -81.413749,
"point": "POINT (-81.413749 28.63679)"
}
permissions
Type: object
Purpose: Defines the visibility and display permissions that control how and where the listing and its content can be shown.
Related articles:
https://help.repliers.com/en/article/understanding-listing-permissions-in-the-api-yj6n9y/
Example:
"permissions": {
"displayAddressOnInternet": "Y",
"displayPublic": "Y",
"displayInternetEntireListing": "Y"
}
images
Type: array
Purpose: Represents the collection of listing photos, used to visually present the property. These represent the relative paths to the Repliers CDN, where the photos are stored: https://cdn.repliers.io/
Related articles:
https://help.repliers.com/en/article/listing-images-implementation-guide-198p8u8/
Example:
"images": [
"sample/IMG-MFRO6274516_0.jpg",
"sample/IMG-MFRO6274516_1.jpg",
...
"sample/IMG-MFRO6274516_17.jpg",
"sample/IMG-MFRO6274516_18.jpg",
"sample/IMG-MFRO6274516_19.jpg"
]
photoCount
Type: field (integer)
Purpose: Stores the total number of photos currently associated with the listing.
Example:
"photoCount": 20
details
Type: object
Purpose: Groups the core descriptive details of the property such as structure, layout, room counts, style, and notable interior or exterior features.
Example:
"details": {
"airConditioning": "Ceiling Fan(s), Heat Pump",
"basement1": "Finished",
"basement2": null,
"centralVac": null,
"den": null,
"description": "Welcome Home! This charming home is waiting for you to make it your own. Home has had a few recent updates and has maintained its 80's style charm. Large living area on main floor is perfect for hanging out and relaxing or you can move the party to the basement or one of two decks. Want to entertain ? Check out the amazing backyard with an in-ground swimming pool. This home is also very close to shops, stores and restaurants. Look no further. This is the home for you",
"elevator": null,
"exteriorConstruction1": "Wood Siding",
"exteriorConstruction2": null,
"extras": "Dishwasher, Disposal, Gas Range",
"furnished": null,
"garage": null,
"heating": "Heat Pump",
"numBathrooms": 3,
"numBathroomsPlus": null,
"numBedrooms": 3,
"numBedroomsPlus": null,
"numFireplaces": null,
"numGarageSpaces": 2,
"numParkingSpaces": null,
"numRooms": 1,
"numRoomsPlus": null,
"patio": "Deck",
"propertyType": "Residential",
"sqft": "2189",
"style": "Single Family Residence",
"swimmingPool": null,
"virtualTourUrl": null,
"yearBuilt": "1980",
"landAccessType": null,
"landSewer": null,
"viewType": null,
"zoningDescription": null,
"analyticsClick": null,
"moreInformationLink": null,
"alternateURLVideoLink": null,
"flooringType": "Carpet, Tile",
"foundationType": "Basement, Slab",
"landscapeFeatures": null,
"fireProtection": "Smoke Detector(s)",
"roofMaterial": "Composition",
"farmType": null,
"zoningType": null,
"businessType": null,
"businessSubType": null,
"landDisposition": null,
"storageType": null,
"constructionStyleSplitLevel": null,
"constructionStatus": null,
"loadingType": null,
"ceilingType": null,
"liveStreamEventURL": null,
"energuideRating": null,
"amperage": null,
"sewer": "Public Sewer",
"familyRoom": null,
"zoning": "RM-2",
"driveway": null,
"leaseTerms": null,
"centralAirConditioning": null,
"certificationLevel": null,
"energyCertification": null,
"parkCostMonthly": null,
"commonElementsIncluded": null,
"greenPropertyInformationStatement": null,
"handicappedEquipped": null,
"laundryLevel": null,
"numKitchens": 2,
"numKitchensPlus": null,
"sqftRange": null,
"numDrivewaySpaces": null,
"HOAFee": null,
"HOAFee2": null,
"HOAFee3": null,
"waterSource": "City",
"livingAreaMeasurement": null,
"waterfront": null,
"bathrooms": [],
"numBathroomsHalf": null
},
daysOnMarket
Type: field (integer)
Purpose: Stores the number of days the listing has been on the market, as retrieved from the MLS® feed.
Related articles:
Example:
"daysOnMarket": 18
simpleDaysOnMarket
Type: field (integer)
Purpose: Stores a simplified days-on-market calculation, based on the date difference between the current date and the listing date.
Related articles:
Example:
"simpleDaysOnMarket": 11
occupancy
Type: field (string)
Purpose: Describes the occupancy status of the property, such as whether it is owner-occupied, tenant-occupied, or vacant.
Example:
"occupancy": "Vacant"
updatedOn
Type: field (string)
Purpose: Records the timestamp when this listing object was last updated in the data feed.
Related articles:
Example:
"updatedOn": "2025-02-12T17:22:21.000-00:00"
condominium
Type: object (optional, condo listings only)
Purpose: For condo listings, captures condominium-specific data such as corporation details, fees, unit identifiers, parking and locker information, and building amenities.
Example:
"condominium": {
"buildingInsurance": null,
"condoCorp": "AIDA MOLINA",
"condoCorpNum": null,
"exposure": null,
"lockerNumber": null,
"locker": null,
"parkingType": "Detached",
"pets": "No",
"propertyMgr": null,
"stories": "4",
"fees": {
"cableInlc": null,
"heatIncl": null,
"hydroIncl": null,
"maintenance": null,
"parkingIncl": null,
"taxesIncl": null,
"waterIncl": null
},
"lockerUnitNumber": null,
"ensuiteLaundry": null,
"sharesPercentage": null,
"lockerLevel": null,
"unitNumber": null,
"amenities": []
}
commercial
Type: object (optional, commercial listings only)
Purpose: For commercial listings, captures commercial-specific data such as business type, building description, areas (industrial/office/retail), utilities, expenses, zoning, bay and shipping door specs, lease terms, and operational characteristics.
Example:
"commercial": {
"amps": null,
"areaInfluences": {
"1": "Major Highway",
"2": "Public Transit"
},
"baySize": {
"1": {
"inches": "9",
"feet": "25"
},
"2": {
"inches": "9",
"feet": "57"
}
},
"expenses": {
"operating": null,
"yearly": null,
"insurance": null,
"maintenance": null,
"management": null,
"water": null
},
"businessType": "Retail Store Related",
"ceilingHeightInches": null,
"ceilingHeightFeet": null,
"chattels": null,
"commonAreaUpcharge": null,
"communityCode": null,
"crane": "N",
"energyCertified": null,
"financialStatementsAvailable": null,
"franchise": null,
"freestanding": "N",
"greenPropertyInfoStatement": "N",
"grossSalesIncome": null,
"handicapEquipped": null,
"operatingHours": "Varies",
"industrialArea": null,
"industrialAreaCode": null,
"inventoryValuesAtCost": null,
"llbo": null,
"lotCode": "Unit",
"listPriceCode": "Gross Lease",
"minLeaseTermMonths": "12",
"officeArea": null,
"officeAreaCode": null,
"outsideStorage": "N",
"outOfAreaMunicipality": null,
"percentageBuilding": null,
"percentageRent": null,
"rail": null,
"retailArea": "110",
"retailAreaCode": "Sq Ft",
"sewer": "Sanitary Available",
"shippingDoors": {
"driveIn": {
"heightFeet": "8",
"heightInches": null,
"number": "1",
"widthFeet": "8",
"widthInches": null
},
"doubleMan": {
"heightFeet": null,
"heightInches": null,
"number": null,
"widthFeet": null,
"widthInches": null
},
"gradeLevel": {
"heightFeet": null,
"heightInches": null,
"number": null,
"widthFeet": null,
"widthInches": null
},
"truckLevel": {
"heightFeet": "8",
"heightInches": null,
"number": "1",
"widthFeet": "8",
"widthInches": null
}
},
"soilTest": null,
"sprinklers": null,
"survey": "N",
"maxLeaseTermMonths": "60",
"totalAreaCode": "Square Feet",
"trailerParkingSpots": "10",
"assessment": null,
"taxType": "Annual",
"uffi": null,
"utilities": "Yes",
"vacancyAllowance": null,
"sellerPropertyInfoStatement": "N",
"volts": "400",
"water": "Municipal",
"waterSupplyType": "Water System",
"zoning": "Commercial"
}
coopCompensation
Type: field (string)
Purpose: Captures co-operative compensation information offered to cooperating brokerages, where provided by the MLS®.
Example:
"coopCompensation": "2.5% + HST"
lot
Type: object
Purpose: Describes the land parcel associated with the property, including size, dimensions, and key lot characteristics.
Related articles:
https://help.repliers.com/en/article/lot-size-filtering-with-api-parameters-14e482x/
Example:
"lot": {
"acres": 0.2,
"depth": null,
"irregular": null,
"legalDescription": null,
"measurement": null,
"width": null,
"size": "8557",
"source": null,
"dimensionsSource": null,
"dimensions": null,
"squareFeet": 8557,
"features": null,
"taxLot": null
}
nearby
Type: object.
Purpose: Summarizes nearby amenities or points of interest associated with the property or immediate surrounding area.
Example:
"nearby": {
"amenities": [
"Fitness Center",
"Gated Community - No Guard",
"Pool",
"Tennis Courts"
]
}
office
Type: object
Purpose: Contains information about the listing brokerage office.
Example:
"office": {
"brokerageName": "ABC Brokers"
}
openHouse
Type: array
Purpose: Represents the collection of scheduled open-house events for the listing, each with its own time window and basic details.
Related articles:
https://help.repliers.com/en/article/how-to-search-for-listings-with-open-houses-1dzsry0/
Example:
"openHouse": [
{
"date": "2025-12-06",
"startTime": "2025-12-06T18:00:00.000-00:00",
"endTime": "2025-12-06T20:00:00.000-00:00",
"type": "Public",
"status": "Active"
}
]
rooms
Type: array of objects
Purpose: Represents the list of individual rooms in the property, each with its type, level, dimensions, and short description, as captured from the MLS® feed.
Example:
"rooms": [
{
"description": "Primary Bedroom",
"features": "Carpet",
"features2": null,
"features3": null,
"length": "13",
"width": "11",
"level": "First"
},
{
"description": "Kitchen",
"features": "Vinyl",
"features2": null,
"features3": null,
"length": "10",
"width": "11",
"level": "First"
},
{
"description": "Living Room",
"features": "Carpet",
"features2": null,
"features3": null,
"length": "13",
"width": "27",
"level": "First"
}
]
taxes
Type: object
Purpose: Stores property tax information for the listing.
Example:
"taxes": {
"annualAmount": "1350",
"assessmentYear": null
}
timestamps
Type: object
Purpose: Centralizes important lifecycle timestamps for the listing, including listing, photo, IDX, expiry, closed, unavailable, possession, and internal update dates.
Example:
"timestamps": {
"idxUpdated": "2025-02-12T17:22:21.000-00:00",
"listingUpdated": "2025-02-12T17:22:21.000-00:00",
"photosUpdated": "2025-02-12T17:22:21.000-00:00",
"conditionalExpiryDate": null,
"terminatedDate": null,
"suspendedDate": null,
"listingEntryDate": null,
"closedDate": null,
"unavailableDate": null,
"expiryDate": null,
"extensionEntryDate": null,
"possessionDate": "2025-01-24T00:00:00.000-00:00",
"repliersUpdatedOn": "2025-11-01T02:13:03.924Z",
"imageInsightsUpdatedOn": "2025-02-12T17:22:21.000-00:00"
}
agents
Type: array of objects
Purpose: Represents the collection of agents associated with the listing, including their identifiers, contact information, brokerage affiliation, and roles.
Related articles:
Example:
"agents": [
{
"agentId": "MFR712606501",
"boardAgentId": "MFR261239885",
"officeId": "MFR1049393",
"updatedOn": "2025-02-12 17:33:10",
"name": "John Smith",
"board": null,
"boardOfficeId": "BDID0221",
"position": "Salesperson",
"email": "john@smithandpartners.com",
"phones": [
"234-432-4411",
"432-234-1144"
],
"social": [],
"website": "https://smithandpartners/profile/johnsmith",
"photo": {
"small": "https://smithandpartners/profile/johnsmith/img/small.jpg",
"large": "https://smithandpartners/profile/johnsmith/img/large.jpg",
"updatedOn": null
},
"brokerage": {
"name": "ABC Brokers",
"address": {
"address1": "106 Sunrise Village Dr",
"address2": "Suite 200",
"city": "Winter Park",
"state": "FL",
"postal": "32789",
"country": "US"
}
}
}
]
history
Type: array of objects
Purpose: Contains the previous listing records for the same property, identifying how it was listed on the market in the past.
Related articles:
https://help.repliers.com/en/article/accessing-historical-listings-for-an-address-1kfsor7/
Example:
"history": [
{
"mlsNumber": "TCA6124627",
"type": "Lease",
"listPrice": 4000,
"listDate": "2025-11-01T00:00:00.000-00:00",
"lastStatus": "New",
"soldPrice": null,
"soldDate": null,
"images": [
"sample/IMG-ACT6276124_0.jpg",
"sample/IMG-ACT6276124_1.jpg",
"sample/IMG-ACT6276124_2.jpg",
"sample/IMG-ACT6276124_3.jpg",
"sample/IMG-ACT6276124_4.jpg",
"sample/IMG-ACT6276124_5.jpg",
"sample/IMG-ACT6276124_6.jpg",
"sample/IMG-ACT6276124_7.jpg",
"sample/IMG-ACT6276124_8.jpg",
"sample/IMG-ACT6276124_9.jpg",
"sample/IMG-ACT6276124_10.jpg",
"sample/IMG-ACT6276124_11.jpg",
"sample/IMG-ACT6276124_12.jpg"
],
"photoCount": 13,
"office": {
"brokerageName": "ABC1 Properties Inc"
},
"timestamps": {
"idxUpdated": "2024-08-10T20:03:15.000-00:00",
"listingUpdated": "2024-08-10T20:03:15.000-00:00",
"photosUpdated": "2024-08-10T20:03:15.000-00:00",
"conditionalExpiryDate": null,
"terminatedDate": null,
"suspendedDate": null,
"listingEntryDate": null,
"closedDate": null,
"unavailableDate": null,
"expiryDate": null,
"extensionEntryDate": null,
"possessionDate": null,
"repliersUpdatedOn": "2024-11-01T11:01:02.525Z",
"imageInsightsUpdatedOn": "2024-02-10T20:03:15.000-00:00"
}
},
{
"mlsNumber": "ACT6276124",
"type": "Sale",
"listPrice": 735000,
"listDate": "2025-11-01T00:00:00.000-00:00",
"lastStatus": "New",
"soldPrice": null,
"soldDate": null,
"images": [
"sample/IMG-ACT6276124_0.jpg",
"sample/IMG-ACT6276124_1.jpg",
"sample/IMG-ACT6276124_2.jpg",
"sample/IMG-ACT6276124_3.jpg",
"sample/IMG-ACT6276124_4.jpg",
"sample/IMG-ACT6276124_5.jpg",
"sample/IMG-ACT6276124_6.jpg",
"sample/IMG-ACT6276124_7.jpg",
"sample/IMG-ACT6276124_8.jpg",
"sample/IMG-ACT6276124_9.jpg",
"sample/IMG-ACT6276124_10.jpg",
"sample/IMG-ACT6276124_11.jpg",
"sample/IMG-ACT6276124_12.jpg"
],
"photoCount": 13,
"office": {
"brokerageName": "ABC2 Properties Inc"
},
"timestamps": {
"idxUpdated": "2025-02-10T20:03:15.000-00:00",
"listingUpdated": "2025-02-10T20:03:15.000-00:00",
"photosUpdated": "2025-02-10T20:03:15.000-00:00",
"conditionalExpiryDate": null,
"terminatedDate": null,
"suspendedDate": null,
"listingEntryDate": null,
"closedDate": null,
"unavailableDate": null,
"expiryDate": null,
"extensionEntryDate": null,
"possessionDate": null,
"repliersUpdatedOn": "2025-11-01T11:01:02.525Z",
"imageInsightsUpdatedOn": "2025-02-10T20:03:15.000-00:00"
}
}
]
comparables
Type: array of objects
Purpose: Lists comparable properties used for market context, including the distance to each of them.
Related articles:
https://help.repliers.com/en/article/how-to-find-comparable-sold-or-leased-properties-11d7ffo/
Example:
"comparables": [
{
"mlsNumber": "ACT9324839",
"type": "Lease",
"listPrice": 1899,
"listDate": "2025-05-21T00:00:00.000-00:00",
"lastStatus": "Lsd",
"soldPrice": 1899,
"soldDate": "2025-09-01T00:00:00.000-00:00",
...
},
"distance": 1609.359094737515
}
]
estimate
Type: object (optional)
Purpose: Provides an automated valuation model output for the property, including the confidence score for the estimated value.
Related articles:
https://help.repliers.com/en/article/ai-powered-property-estimates-explained-1g0v39s/
https://help.repliers.com/en/article/ai-powered-property-estimates-implementation-guide-6gdbvp/
https://help.repliers.com/en/article/understanding-and-improving-confidence-scores-196k44h/
Example:
"estimate": {
"date": "2025-08-06T20:02:08.899Z",
"high": 361071.8385709083,
"low": 209369.4114290917,
"confidence": 0.265938739777,
"history": {
"mth": {
"2025-05": {
"value": 286171.625
},
...
},
"2024-01": {
"value": 278723.6875
},
"2023-12": {
"value": 277055.6875
}
}
},
"value": 285220.625
},
imageInsights
Type: object.
Purpose: Contains AI-generated insights and scores derived from the listing’s photos, such as classifications and visual quality metrics.
Related articles:
https://help.repliers.com/en/article/quality-scores-feature-implementation-guide-1kkedog/
Example:
"imageInsights": {
"summary": {
"quality": {
"qualitative": {
"features": {
"livingRoom": "average",
"diningRoom": "average",
"kitchen": "average",
"bedroom": "average",
"bathroom": "below average"
},
"overall": "average"
},
"quantitative": {
"features": {
"livingRoom": 3.272913456,
"diningRoom": 3.9916820526,
"kitchen": 3.4209151268,
"bedroom": 3.0213842392,
"bathroom": 2.2479114532
},
"overall": 3.272913456
}
}
},
"images": [
{
"image": "sample/IMG-MFRO6274516_0.jpg",
"classification": {
"imageOf": "Pool",
"prediction": 0.9887194037
},
"quality": null
},
{
"image": "sample/IMG-MFRO6274516_1.jpg",
"classification": {
"imageOf": "Living Room",
"prediction": 0.9746076465
},
"quality": {
"qualitative": "below average",
"quantitative": 2.61353302
}
},
{
"image": "sample/IMG-MFRO6274516_9.jpg",
"classification": {
"imageOf": "Kitchen",
"prediction": 0.9735500813
},
"quality": {
"qualitative": "average",
"quantitative": 3.0072176456
}
},
{
"image": "sample/IMG-MFRO6274516_10.jpg",
"classification": {
"imageOf": "Bedroom",
"prediction": 0.9999357462
},
"quality": {
"qualitative": "below average",
"quantitative": 2.7923178673
}
}
]
}
standardStatus
Type: field (string).
Purpose: Stores a RESO compliant normalized or standardized version of the listing status, harmonized across different boards or resources.
Possible values: "Active", "Active Under Contract", "Canceled", "Closed", "Coming Soon", "Delete", "Expired", "Hold", "Incomplete", "Pending", "Withdrawn"
Example:
"standardStatus": "Active"
boardId
Type: field (integer).
Purpose: Identifies through a Repliers internal ID the MLS® board that is the source of the listing data.
Example:
"boardId": 110
Updated on: 28/11/2025
Thank you!