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

# PropertyMetrics

> Core valuation and physical details about a property.

Used in: [Catalyst Property Event](/catalyst-event-webhooks) via `property.metrics`

## Fields

| Field                 | Type           | Description                              |
| --------------------- | -------------- | ---------------------------------------- |
| `zestimate`           | number         | Estimated property value                 |
| `beds`                | number         | Number of bedrooms                       |
| `baths`               | number         | Number of bathrooms                      |
| `livingAreaSqFt`      | number         | Interior square footage                  |
| `lotSizeAcres`        | number         | Lot size in acres                        |
| `propertyType`        | string         | Property type (e.g. `SINGLE_FAMILY`)     |
| `yearBuilt`           | number         | Year the property was built              |
| `occupancyStatus`     | string         | Occupancy status (e.g. `OWNER_OCCUPIED`) |
| `estimatedTax`        | number         | Estimated annual property tax            |
| `estimatedPrice`      | number         | Goliath's internal valuation             |
| `estimatedRent`       | number         | Estimated monthly rent                   |
| `lastSaleAmount`      | number         | Last recorded sale price                 |
| `lastSaleDate`        | string         | Last recorded sale date                  |
| `nameOnTitle`         | string         | Names as they appear on the deed         |
| `ownerMailingAddress` | string \| null | Owner mailing address, if available      |

## Example

```json theme={null}
{
  "zestimate": 123456,
  "beds": 3,
  "baths": 2,
  "livingAreaSqFt": 1500,
  "lotSizeAcres": 0.15,
  "propertyType": "SINGLE_FAMILY",
  "yearBuilt": 1900,
  "occupancyStatus": "OWNER_OCCUPIED",
  "estimatedTax": 1234.56,
  "estimatedPrice": 120000,
  "estimatedRent": 1500,
  "lastSaleAmount": 50000,
  "lastSaleDate": "2000-01-01",
  "nameOnTitle": "DOE, JOHN; DOE, JANE",
  "ownerMailingAddress": "PO BOX 123, SPRINGFIELD, USA 00000"
}
```

## Notes

<Note>
  `ownerMailingAddress` may be `null` if no mailing address is on file. Always null-check before using.
</Note>

<Note>
  `nameOnTitle` is a semicolon-delimited string when multiple owners are present. Split on `"; "` if you need individual names.
</Note>