Search master profiles
Searches identity-resolved master guest profiles (golden records merged across source systems) for the credential’s property group. Master profiles are group-scoped by design; a property drill-down narrows to entities with at least one member record at that property. Requires scope read:guests.
Authorizations
Authorization: Bearer <token>. Token types resolve to the same scoped credential: a user-generated API key (casa_…, from Account settings — recommended for machines and MCP clients), a WorkOS AuthKit 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. MCP OAuth connector tokens authenticate the MCP server only and are rejected on these REST routes.
Headers
Optional single-property drill-down. When set, narrows the request to this property; it must belong to the caller's group, else 403. A property-pinned API key is already narrowed and ignores this header.
Query Parameters
Free-text match on name, email, or phone.
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.
Opt-in total count. When true/1 and no cursor is set, includes total_count of matching master profiles only (not unclustered guests).
0, 1, true, false Response
Matching master profiles, most recently updated first.
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.