> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightplace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# get_listing

> Read full detail for one listing snapshot.

`get_listing` returns full detail for one listing returned by
`search_listings`.

## Input

```json theme={null}
{
  "listing_id": "listing-record-id"
}
```

| Field        | Type   | Required | Notes                                                |
| ------------ | ------ | -------- | ---------------------------------------------------- |
| `listing_id` | string | Yes      | A listing snapshot id returned by `search_listings`. |

## Output

The tool returns `ListingDetail`.

```json theme={null}
{
  "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`.

## brightplace grades

The `ratings` block summarizes a listing's quality and location as letter
grades on a shared scale. Any grade can be `null` when the underlying data is
not available for that listing, so treat a missing grade as "unknown," not
"bad." Present them to renters as a helpful summary, not as the sole basis for
a decision.

| Grade               | What it measures                                       |
| ------------------- | ------------------------------------------------------ |
| `brightplace_grade` | Overall resident-satisfaction quality of the property. |
| `review_confidence` | Confidence of rating based on review volume.           |
| `walking_grade`     | How walkable the surrounding area is.                  |
| `transit_grade`     | Access to public transit.                              |
| `biking_grade`      | How bike-friendly the area is.                         |
| `schools_grade`     | Quality of nearby schools.                             |

`review_confidence` is a separate signal, not a letter grade — read it
alongside `brightplace_grade`. An `A` backed by `low` confidence rests on few
reviews.