Get Listing Details
Full listing details — description, all photos, and extended fields for a single MLS number. Requires an OAuth access token.
/v1/listings/:ListingIdAuthentication
Authorization: BearerRequires OAuth access token (scope: listings)
Query Parameters
ListingIdstringMLS listing number (URL path parameter)
Responses
application/jsonListingIdstringMLS listing number
ListPricenumberCurrent listing price in USD
PreviousListPricenumberPrevious listing price before last price change
ClosePricenumberFinal sale/close price (null if not sold)
BedroomsTotalnumberTotal number of bedrooms
BathroomsTotalIntegernumberTotal number of bathrooms
LivingAreanumberLiving area in square feet
LotSizeSquareFeetnumberLot size in square feet
YearBuiltnumberYear the property was built
YearBuiltDetailsstringNew Construction or Resale
DaysOnMarketnumberNumber of days the listing has been on market
CitystringCity name
StateOrProvincestringState abbreviation (e.g., FL)
PostalCodestringZIP/postal code
StreetNumberstringStreet number
StreetDirPrefixstringStreet direction prefix (e.g., NW, SE)
StreetNamestringStreet name
UnitNumberstringUnit or apartment number
UnparsedAddressstringFull address as a single string
StandardStatusstringListing status: Active, Pending, Closed
PropertyTypestringProperty type (Residential, Commercial Sale, etc.)
PropertySubTypestringProperty subtype (Condominium, Townhouse, etc.)
SubdivisionNamestringSubdivision or community name
BuildingNamestringBuilding name (for condos)
CountyOrParishstringCounty name
PublicRemarksstringPublic listing description/remarks
ListOfficeNamestringListing office/brokerage name
ListingTermsstringAccepted financing terms (Cash, Conventional, FHA, etc.)
FurnishedstringFurnished status (Furnished, Unfurnished, null)
WaterfrontYNbooleanWhether the property is on the waterfront
WaterfrontFeaturesarrayWaterfront features (Ocean Front, Intracoastal, etc.)
PoolPrivateYNbooleanWhether the property has a private pool
PoolFeaturesarrayPool features (Association, Heated, etc.)
ViewstringView description (Bay, Ocean, Garden, etc.)
SeniorCommunityYNbooleanWhether it is a 55+ senior community
PetsAllowedstringPet policy (Yes, Breed Restrictions, No, etc.)
AssociationFeenumberMonthly HOA/association fee in USD
TaxAnnualAmountnumberAnnual property tax amount
TaxYearnumberTax year for TaxAnnualAmount
GarageSpacesnumberNumber of garage spaces
CoveredSpacesnumberNumber of covered parking spaces
ParkingFeaturesstringParking features (Assigned, Valet, Driveway, etc.)
StoriesnumberNumber of stories in the property
ConstructionMaterialsstringConstruction materials (Concrete, Block, Wood, etc.)
ArchitecturalStylestringArchitectural style (High Rise, Detached, etc.)
RoofstringRoof type (Barrel Roof, Shingle, Flat, etc.)
CoolingstringCooling system (Central Air, Ceiling Fan(s), etc.)
HeatingstringHeating system (Central, Electric, etc.)
FlooringstringFlooring type (Tile, Hardwood, Laminate, etc.)
AppliancesstringIncluded appliances (Dishwasher, Refrigerator, etc.)
InteriorFeaturesstringInterior features (Walk-In Closet(s), Built-in Features, etc.)
ExteriorFeaturesstringExterior features (Balcony, Pool, Patio, etc.)
CommunityFeaturesstringCommunity amenities (Pool, Fitness Center, Gated, etc.)
LaundryFeaturesstringLaundry features (In Unit, Common Area, etc.)
WindowFeaturesstringWindow features (Impact Glass, Blinds, etc.)
SewerstringSewer type (Public Sewer, Septic, etc.)
WaterSourcestringWater source (Municipal Water, Well, etc.)
LeaseTermstringLease term (for rentals)
LeaseAmountFrequencystringLease payment frequency (Monthly, Annually, etc.)
SpecialListingConditionsstringSpecial conditions (Short Sale, REO, etc.)
VirtualTourURLUnbrandedstringVirtual tour URL (unbranded)
DirectionFacesstringDirection the property faces (North, East, etc.)
LotFeaturesstringLot features (Corner Lot, Cul-De-Sac, etc.)
LevelsstringNumber of levels (One, Two, Three Or More)
OriginatingSystemKeystringMLS data source identifier
OriginatingSystemNamestringMLS data source name
OriginalEntryTimestampstringISO 8601 date when the listing was first entered
ModificationTimestampstringISO 8601 date of last modification
MajorChangeTimestampstringISO 8601 date of last major change (status/price)
CloseDatestringClose/sale date (null if not sold)
MediaarrayPhotos array with Order, MediaURL, and ShortDescription
coordinatesobjectProperty coordinates: { lng, lat }