List gift card categories
Lists the gift card categories with their display names.
Lists the gift card categories with their display names.
Returns the complete list { items: [{ category, name }] }, without paging. Use a category value to
filter search and the catalog. The route takes no query parameters.
PartnerApiKeyX-Partner-Key<token>Partner API Key (X-Partner-Key)
OK
- response
The complete category reference list. The taxonomy is small and fixed, so it is not paged.
items*array<>curl -X GET 'https://api.sandbox.openroam.com/v1/giftcards/categories'{ "items": [ { "category": "shopping", "name": "string" } ]}Gift card catalog GET
Returns every gift card with its offers, page by page, for partner inventory. Returns `{ items, nextCursor }`, ordered by card ID, with the search filters except `q`. Continue with `nextCursor` as `cursor`, the same filters and the same `currency` until it is null; a page can hold fewer cards than `limit`, even none, while `nextCursor` is not null. A cursor reused with other filters or another currency gives 400 / 10001. The walk is not a frozen snapshot: a card that appears or disappears during it may be missing. Quote confirms the final price and availability.
Quote gift cards POST
Prices the order body with current prices, without placing an order. Takes the same body as order and checks it the same way: each item completely (its inputs, then its `publicId`, then its price) before the next, in request order. The first failure aborts the quote and is named at `items[i]`, as the order names it, for example 409 / 11002 at `items[i].inputs.maxPrice` when the current price is above it. A range offer may be quoted on an equivalent offer of the same card that sells the same value for less: the item then returns that offer's `publicId`, which the order should use.