Properties

A property is a building or address in your portfolio. It holds the amenities, pet policy, and description the AI leasing agent uses to answer prospect questions.

Fields

Field	Type	Writable	Description
`id`	number	read-only	RentSimple identifier
`name`	string	required	Display name of the property
`address`	object	required	`street`, `city`, `state`, `zip` (all required)
`propertyType`	string	optional	`MultiFamily` or `SingleFamily`
`description`	string	optional	Shown to prospects and used by the agent to answer questions
`petPolicy`	string	optional	Free text (e.g. `Cats and small dogs, $50/mo pet rent`)
`amenities`	string[]	optional	Building amenities (e.g. `["Gym", "Rooftop deck"]`)
`images`	string[]	optional	Image URLs
`externalId`	string	optional	Your own identifier
`unitCount`	number	read-only	Number of units under this property
`createdAt` / `updatedAt`	string	read-only	ISO-8601 timestamps

List filters: city

Example: create a property

Request


curl -X POST https://rentsimple.ai/api/v1/properties \
  -H "Authorization: Bearer $RENTSIMPLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Elm Street Residences",
    "address": { "street": "14 Elm St", "city": "San Francisco", "state": "CA", "zip": "94102" },
    "propertyType": "MultiFamily",
    "petPolicy": "Cats and small dogs welcome",
    "externalId": "yardi-0042"
  }'

Response — 200 OK


{
  "data": {
    "id": 412,
    "name": "Elm Street Residences",
    "address": { "street": "14 Elm St", "city": "San Francisco", "state": "CA", "zip": "94102" },
    "propertyType": "MultiFamily",
    "description": null,
    "petPolicy": "Cats and small dogs welcome",
    "amenities": [],
    "images": [],
    "externalId": "yardi-0042",
    "unitCount": 0,
    "createdAt": "2026-06-05T14:22:08Z",
    "updatedAt": "2026-06-05T14:22:08Z"
  }
}

Before you delete. A property must be empty before it can be deleted, or the request returns 409 Property not empty. See Portfolio Overview.