Search reservations
Searches reservations for the credential’s scope, ordered by stay start date (newest first). All filters are optional and combine with AND. Requires scope read:reservations.
Authorizations
Authorization: Bearer <token>. Token types resolve to the same scoped credential: a user-generated API key (casa_…, from Account settings — recommended for first-party machines and MCP clients), a partner credential access token (third-party agents; REST-only), a session JWT (the web app; org and role come from verified token claims), or a static token. API keys are group-scoped, optionally pinned to one property at creation. Personal API keys and partner credentials accept X-Property-Id to drill down to one property in the group. A property-pinned API key ignores that header. MCP OAuth connector tokens authenticate the MCP server only and are rejected on these REST routes.
Headers
Optional single-property drill-down. Narrows this request to one property in the caller's group. A property outside the group returns 403. Personal API keys and partner credentials accept this header. A property-pinned API key ignores it. Casa Layer sign-in tokens reject it.
Query Parameters
Free-text match on the linked guest's name or email.
Canonical reservation status.
pending, confirmed, in_progress, completed, cancelled, declined, no_show Source-system reservation ID. Requires integration_id.
Casa Layer integration ID that owns the source_id. Required with source_id. List IDs with GET /v1/integrations (scope read:properties).
Include stays starting on/after this ISO date.
Include stays starting on/before this ISO date.
Canonical channel category.
direct, ota, gds, corporate, walk_in, channel_manager, other Page size — rows returned per call (1–500). This is NOT a cap on the total dataset: follow next_cursor to retrieve every matching row.
1 <= x <= 500Opaque pagination token from a previous response's next_cursor. Omit for the first page. A malformed token returns 400 invalid_cursor.
Response
Matching reservations.
Keyset-pagination fields present on every list/search response. When has_more is true, re-request with cursor set to next_cursor; repeat until next_cursor is null to retrieve the full result set.