Browse available gifts for user

Browse Available Gifts

Retrieves all gifts currently available for the user to redeem, with optional filtering by category and language-based localization.

This endpoint automatically filters out gifts that are not relevant to the user:

Inactive or cancelled gifts are excluded

Expired gifts (expiresAt in the past) are excluded

Out of stock gifts are excluded

Targeted gifts are only shown if the user matches the targeting criteria (gender, age, country, city, segment)

Public gifts are always visible to all users. Private (targeted) gifts are only shown when the user's profile — fetched from the Registration service — matches the gift's targeting rules.

Localization

Pass the `language` query parameter (e.g. `?language=ar`) to resolve `name` and `imageUrl` to that language. Falls back to default values when no translation exists. No `localizedContent` map is exposed in the response — you get resolved strings only.

Pagination

Results are paginated. Use pageNumber and pageSize to control the page. Results are sorted by ranking (ascending), then by creation date (descending).

{ "items": [ { "id": "b1c2d3e4-5678-9abc-def0-111111111111", "name": "سماعات فاخرة", "imageUrl": "https://example.com/headphones-ar.png", "categoryName": "Electronics", "pricePoints": 500, "priceSar": 50, "priceDisplay": "Both", "isUnlimited": false, "remainingStock": 7, "ranking": 1, "expiresAt": "2026-12-31T23:59:59Z", "createdAt": "2026-03-20T09:00:00Z" }, { "id": "b1c2d3e4-5678-9abc-def0-222222222222", "name": "Coffee Voucher", "imageUrl": null, "categoryName": "Food & Drinks", "pricePoints": 100, "priceSar": null, "priceDisplay": "Points", "isUnlimited": true, "remainingStock": null, "ranking": 2, "expiresAt": null, "createdAt": "2026-03-18T12:00:00Z" } ], "pagination": { "currentPage": 1, "pageSize": 10, "totalCount": 2, "totalPages": 1, "hasPrevious": false, "hasNext": false } }

Browse available gifts for user