Journey Docs
Partner APIWindfall

Windfall Lookup Endpoints

Look up guest intelligence by PMS hash, reservation, or member ID

GET /partner/windfall/guests/:hashedPmsGuestId

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

hashedPmsGuestIdpathstringrequired

HMAC hash of the PMS guest ID, as produced by the Windfall PMS integration

Response

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

Request

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

GET /partner/windfall/reservations/:reservationId

Look up guest intelligence by external reservation UUID.

Path Parameters

reservationIdpathstringrequired

External reservation UUID (must be a valid UUID)

Request

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

GET /partner/windfall/members/:memberId

Retrieve all Windfall intelligence records for a Journey member ID.

Path Parameters

memberIdpathnumberrequired

Internal numeric member ID

Returns an array of WindfallGuestIntelResponse records.


GET /partner/windfall/stats

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

Request

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

On this page