Skip to main content
← Back to API Integration Requires an API key — see Authentication.

Get product offers feed

GET https://tyviso.com/[product]/api?preview=[true/false]&flow=[category] Returns the full payload used to render your hosted Rewards page or widget: the header template, CTA styling, social-proof configuration, and the live offers for each placement (hero, popular, all).
This is a separate path from the tracking API — it’s not a tracking request.
Parameters
string
Category of offers to return.
string
true or false — preview unpublished offers before they go live.
See Errors for error shapes.

Get a single use code

GET https://tyviso.com/rewards/unique-codes Returns the next unclaimed single use code from your pool and marks it as issued, so each customer receives a unique code. Call it once per customer at the moment you show or send the reward.
This endpoint is authenticated with its own token in a custom token header — not the X-API-Key used elsewhere in this reference. Ask your Tyviso account manager for it.
Parameters
string
required
The offer to draw a code for. Omit it and the response is not-found.
string
The single use code to give the customer. When the pool is exhausted this returns the string "No more codes available!" — handle that case in your UI and top up the pool.
Pool empty — still a 200:
not-authorized — no token, or the token is wrong:
not-found — the id parameter is missing:
Last modified on November 11, 2026