# Windfall Lookup Endpoints
> Source: /api-reference/partner/windfall/lookup
> Look up guest intelligence by PMS hash, reservation, or member ID

# Windfall Lookup Endpoints

## GET /partner/windfall/guests/:hashedPmsGuestId [#get-partnerwindfallguestshashedpmsguestid]

Look up a guest's Journey identity and enriched intelligence by their PMS guest hash. Used by PMS integrations to identify members at check-in.

### Path Parameters [#path-parameters]

<ParamField path="hashedPmsGuestId" type="string" required>
  HMAC hash of the PMS guest ID, as produced by the Windfall PMS integration
</ParamField>

### Response [#response]

Returns a `WindfallGuestIntelResponse` — the linked member record, enriched social data, and match confidence score. Returns `404` when no match is found.

<RequestExample>

```bash cURL
curl "https://api-prd.cf.journey.com/v1/partner/windfall/guests/abc123hash" \
  -H "X-API-Key: jny_xxxx"
```

```typescript TypeScript
const intel = await fetch(
  `https://api-prd.cf.journey.com/v1/partner/windfall/guests/${hashedGuestId}`,
  { headers: { 'X-API-Key': apiKey } }
).then(r => r.json());
```

</RequestExample>

---

## GET /partner/windfall/reservations/:reservationId [#get-partnerwindfallreservationsreservationid]

Look up guest intelligence by external reservation UUID.

### Path Parameters [#path-parameters-1]

<ParamField path="reservationId" type="string" required>
  External reservation UUID (must be a valid UUID)
</ParamField>

<RequestExample>

```bash cURL
curl "https://api-prd.cf.journey.com/v1/partner/windfall/reservations/12345678-1234-5678-9012-123456789012" \
  -H "X-API-Key: jny_xxxx"
```

</RequestExample>

---

## GET /partner/windfall/members/:memberId [#get-partnerwindfallmembersmemberid]

Retrieve all Windfall intelligence records for a Journey member ID.

### Path Parameters [#path-parameters-2]

<ParamField path="memberId" type="number" required>
  Internal numeric member ID
</ParamField>

Returns an array of `WindfallGuestIntelResponse` records.

---

## GET /partner/windfall/stats [#get-partnerwindfallstats]

Returns aggregate statistics about the Windfall data pipeline for your organization.

<RequestExample>

```bash cURL
curl "https://api-prd.cf.journey.com/v1/partner/windfall/stats" \
  -H "X-API-Key: jny_xxxx"
```

</RequestExample>