Search Fulfillments
Search fulfillments with rich filtering and enriched response
/partner/fulfillments/searchOverview
Enriched fulfillment search. Returns nested member, offer, reservation, and property summaries in a single response — purpose-built for fulfillment management UIs that need to display all context without additional lookups.
Unlike GET /partner/fulfillments, this endpoint:
- Returns enriched sub-objects (member name, offer details, property info)
- Supports full-text search across offer name, verification code, and member name
- Supports date-range filters across claimed/expired/fulfilled timestamps
- Supports redemption type filtering (defaults to excluding
staticoffers) - Includes
operatorNotes,howToRedeem, andstaffInstructionsfrom the offer
Authentication
Requires a partner API key with the partner:fulfillments:read scope, sent as X-API-Key.
Query Parameters
qquerystringFull-text search across offer name, verification code, and member name. Minimum 2 characters.
statusquerystringComma-separated statuses: claimed, fulfilled, pending_approval, approved, rejected, expired
redemptionTypequerystringComma-separated redemption types: direct, requireApproval, externalCode, static, propertyInternal, journeyInternal, user, notification, giveaway.
Default behavior when omitted: excludes static only — all other types are returned. Pass an explicit list to restrict to specific types.
propertyIdquerynumberFilter by internal property ID
organizationIdquerystringExternal org ID (HXP UUID or WorkOS org ID). Required for superadmin keys querying a specific org; ignored for org-scoped keys.
claimedAfterquerystringISO 8601 — include fulfillments claimed on or after this date
claimedBeforequerystringISO 8601 — include fulfillments claimed on or before this date
expiresAfterquerystringISO 8601 — include fulfillments expiring on or after this date
expiresBeforequerystringISO 8601 — include fulfillments expiring on or before this date
fulfilledAfterquerystringISO 8601 — include fulfillments completed on or after this date
fulfilledBeforequerystringISO 8601 — include fulfillments completed on or before this date
offsetquerynumberdefault: 0Pagination offset
limitquerynumberdefault: 20Results per page (max 100)
Response
itemsarrayrequiredEnriched fulfillment records
item fields
idstringstatusstringclaimed | fulfilled | pending_approval | approved | rejected | expiredapprovalStatusstring | nullredemptionTypestringverificationCodestring | nullqrCodeUrlstring | nullpointsChargednumber | nullretailValuenumber | nullclaimedAtstring | nullfulfilledAtstring | nullexpiresAtstring | nullcanApprovebooleancanFulfillbooleanoperatorNotesstring | nullmemberobject{ firstName, lastName, externalMemberId }
offerobject | null{ name, publicName, imageThumbUrl, categorySlug, categoryName, fulfillmentType, requiresApproval, howToRedeem, staffInstructions }
reservationobject | null{ externalId, checkIn, checkOut }
propertyobject{ id, externalId, name }
totalnumberrequiredoffsetnumberrequiredlimitnumberrequiredRequest
curl "https://api-prd.cf.journey.com/v1/partner/fulfillments/search?status=pending_approval&limit=20" \
-H "X-API-Key: jny_xxxx"Bruno
bruno/Partner/Fulfillments/Search Fulfillments.bru