# Windfall Intelligence
> Source: /api-reference/partner/windfall/overview
> PMS guest hash lookup and member identity intelligence for partner integrations

# Windfall Intelligence

The Windfall endpoints provide guest identity intelligence — linking PMS guest hashes to Journey member profiles, enriched with social and behavioral data. Used by PMS integrations and property staff tools to understand who is checking in.

<Warning>
  These endpoints require both `partner:guests:read` and `partner:guests:pii:read` and are subject to data privacy requirements. All responses are scoped to your organization.
</Warning>

## Authentication [#authentication]

Requires a partner API key with both `partner:guests:read` and `partner:guests:pii:read`.

## Endpoints [#endpoints]

| Method | Path | Description |
|--------|------|-------------|
| `GET` | `/partner/windfall/stats` | System stats |
| `GET` | `/partner/windfall/guests/:hashedPmsGuestId` | Lookup by PMS guest hash |
| `GET` | `/partner/windfall/reservations/:reservationId` | Lookup by external reservation UUID |
| `GET` | `/partner/windfall/members/:memberId` | All intel records for a member |

## Organization Scoping [#organization-scoping]

All partner windfall endpoints require an organization context. Requests from org-scoped keys are automatically scoped; keys without organization context return `403 Forbidden`.