Schemas

Temporary authorization and baseline for quest chain polling.

Active quest chains of the user, each with its tasks and progress. Empty when the user exists but takes part in no active chain, and also empty when the user is unknown — read user.exists to tell those apart.

Tasks from past (expired or completed) quest chains whose reward has not yet been claimed. The user may call the reward-claim endpoint for any of these.

Facts about the requested user that hold regardless of chain membership.

The quest chain this entry describes.

Levels of the chain, ordered by order_by. Contains a single virtual level when levels are disabled.

Progress of the requested user inside this chain.

Final reward of this quest chain, or null when the chain has no final reward.

Quest chain unique identifier.

Quest chain name, safe to show to the user as is.

Long-form quest chain description, or null when the chain has none.

Absolute URL of the chain logo, or null when the chain has none.

Absolute URL of the chain background image, or null when the chain has none.

Moment the chain becomes joinable, ISO 8601 with offset. Null means the chain has no explicit start and is governed by its status alone.

Moment the chain stops accepting progress, ISO 8601 with offset. Null means the chain has no explicit end.

Lifecycle state of the quest chain itself. Only active, cooldown, pending_reward chains are returned by the active-chains endpoint;

Identifier of the platform that owns the chain. Always the caller's own platform.

Identifier of the advertiser funding the chain rewards, or null for a platform-funded chain.

When true the tasks may be completed in any order; when false the chain is step-by-step and unreached tasks are reported with user_status: "locked".

When true the tasks are grouped into levels; when false all tasks belong to a single virtual level.

Level identifier, or null for the virtual common level when the chain has no levels.

Level display name, or null for the virtual common level when the chain has no levels.

Whether the tasks of this level are visible to the user.

Whether all tasks in this level are completed or claimed by the user.

Tasks belonging to this level, ordered by sequence_number.

Task unique identifier. Pass it to the reward-claim endpoint.

Position of the task inside the chain, starting at 1. Tasks arrive already ordered by this field.

Task name, safe to show to the user as is.

Long-form task description, or null when the task has none.

Type of the event that completes this task, for example transaction, link_account or kyc. Send it back through the events endpoint when the user performs the action.

Minimum event amount required to complete the task, or null when the task has no amount condition.

Currency the condition_min_amount is denominated in, for example USD. Null when the task has no amount condition.

Only events at or after this moment can complete the task, ISO 8601 with offset. Null when the task has no lower time bound.

Only events at or before this moment can complete the task, ISO 8601 with offset. Null when the task has no upper time bound.

Reward kind, for example credit, item, multiplier or case. Null when the task carries no reward. For a task completed by a retroactive event this is the retro reward, which may differ from the regular one.

Human-readable reward name, or null when the task carries no reward.

Numeric reward value; meaningful for credit and multiplier rewards. Null when the reward has no numeric value.

Absolute URLs of the reward images, or null when the reward has none.

State of the task for the requested user, or null when no per-user record exists yet. See QuestChainUserTaskStatus for the individual values.

Identifier of the level this task belongs to, or null when the task is not assigned to any level.

State of this user's participation in the chain.

Completion of the chain in percent, 0 to 100.

Moment the user joined the chain, ISO 8601 with offset.

Moment the user completed the chain, ISO 8601 with offset. Null while the chain is still in progress.

Number of tasks the user has completed or already claimed.

Total number of tasks in the chain.

Final quest chain reward identifier.

Reward code sent to the reward provider, or null when it is not set.

Human-readable reward name, or null when the reward has none.

Numeric reward value, or null when the reward has no numeric value.

Absolute URLs of the reward images, or null when the reward has none.

Whether the requested user can claim this final chain reward now.

Advertiser-defined event type, for example deposit.completed.

Moment the event occurred, formatted as an ISO 8601 UTC timestamp.

Non-negative event amount when the event represents a measurable value.

Currency or unit associated with amount, when applicable.

Advertiser-side idempotency or audit reference for this event.

Additional advertiser-defined event attributes.

Always true when the account connection completed successfully.

Onward user identifier.

Identifier of the user in the platform's system.

Identifier of the user in the advertiser's system.

Validated URL to which the integration should redirect the user.

Identifier of the account-link event created by Onward.

Identifiers of outbox records processed as part of the connection workflow.

Internal Onward identifier of the user.

Unique user identifier supplied by the platform.

Moment the user was created, formatted as an ISO 8601 timestamp.

Indicates whether the user already existed at the moment of the request.

Internal identifier of the recorded event.

The caller-scoped user identifier supplied in the request.

The caller-defined event type supplied in the request.

Moment Onward first recorded the event, formatted as an ISO 8601 timestamp.

received for a newly recorded event or duplicate when the same user, event type, and event timestamp were already recorded.

Identifier of the user's task-progress record that was claimed.

Identifier of the claimed task.

Internal Onward identifier of the user.

ISO 8601 timestamp when the reward claim was recorded.

Identifier of the quest chain whose chain-level reward was claimed.

Internal Onward identifier of the user.

ISO 8601 timestamp when the chain reward claim was accepted.