OwnerRez API v2 — Reference

# OwnerRez API > Vacation rental management API for bookings, properties, guests, messaging, payments, and more. This file orients AI agents; the machine-readable contract is at /openapi/v2.json. ## Agent instructions - Base URL: `https://api.ownerrez.com`. All endpoints require authentication. - Auth: OAuth 2.0 bearer token (`Authorization: Bearer {token}`), or HTTP Basic with your OwnerRez account email as the username and your Personal Access Token (`pt_…`) as the password (`Authorization: Basic {base64(email:token)}`). - Responses are JSON. Dates/times are ISO 8601 and UTC unless noted; booking arrival/departure dates are in the property's local time. - Monetary amounts are decimals (e.g. `125.00`), not integer cents. - Entity IDs are integers, unique per entity type. - List endpoints paginate with `limit` (default 20, max 100) and `offset`. - Where supported (e.g. bookings, messages), use `since_utc` for incremental sync and store the latest `updated_utc` you see as the next watermark. - Errors return JSON with a `messages` array of human-readable strings. Status codes: 400 = bad request / validation, 401 = authentication, 403 = permission, 404 = not found. - Prefer the current API (v2). Legacy versions remain documented below but should not be used for new integrations. ## Documentation - [OpenAPI 3.0 spec](/openapi/v2.json): the full machine-readable contract for v2. - [Reference docs](/help/v2): human-readable, interactive API reference. - [Operation index](/help/v2/index.md): every operation, each linked to a self-contained markdown page with enums inlined. - [OpenAPI 3.0 spec (legacy v1)](/openapi/v1.json): the full machine-readable contract for v1. - [Reference docs (legacy v1)](/help/v1): human-readable, interactive API reference. - [Operation index (legacy v1)](/help/v1/index.md): every operation, each linked to a self-contained markdown page with enums inlined. - [Guides](/help/guides): API how-to articles. ## Resource

{"x-generator":"NSwag v14.7.1.0 (NJsonSchema v11.6.1.0 (Newtonsoft.Json v13.0.0.0))","openapi":"3.0.0","info":{"title":"OwnerRez API","description":"REST API for the OwnerRez vacation-rental platform — read and manage bookings, guests, properties, listings, messaging, and more.\r\n\r\n## Base URL\r\n\r\nAll requests go to `https://api.ownerrez.com`. Paths are versioned under `/v2`.\r\n\r\n## Authentication\r\n\r\nEvery request must be authenticated with one of:\r\n\r\n- **OAuth 2.0** — send