Skip to main content
get_listing returns full detail for one listing returned by search_listings.

Input

{
  "listing_id": "listing-record-id"
}
FieldTypeRequiredNotes
listing_idstringYesA listing snapshot id returned by search_listings.

Output

The tool returns ListingDetail.
{
  "listing_id": "listing-record-id",
  "unit_id": "unit-id",
  "property": {
    "name": "Example Apartments",
    "address": "123 Main St",
    "city": "Brooklyn",
    "state": "NY",
    "zip": "11201",
    "latitude": 40.7128,
    "longitude": -74.006,
    "building_type": "apartment",
    "year_built": 2019,
    "description": "Modern apartment community.",
    "amenities": ["Pool", "Fitness center"],
    "images": ["https://example.com/property.jpg"]
  },
  "unit": {
    "name": "Apt 5B",
    "floor_plan": "A1",
    "beds": 1,
    "baths": 1,
    "sqft": 720,
    "floor": 5,
    "amenities": ["In-unit laundry"],
    "images": {
      "photos": ["https://example.com/unit.jpg"],
      "floorplans": [],
      "other": []
    }
  },
  "economics": {
    "rent": 3400,
    "rent_max": null,
    "deposit": 500,
    "concessions": "1 month free",
    "lease_term": 12,
    "available_at": "2026-07-01",
    "fees": [],
    "listing_url": "https://operator.example/listing"
  },
  "ratings": {
    "brightplace_grade": "A",
    "review_confidence": "high",
    "walking_grade": "A",
    "transit_grade": "B+",
    "biking_grade": "B",
    "schools_grade": null
  },
  "reviews_summary": "Residents mention responsive maintenance.",
  "nearby_schools": []
}
Unknown listing ids return LISTING_NOT_FOUND with the offending listing_id in error.details.