Resolve offer by short hash
Resolves an offer from the customer-clicked URL /i/<short_hash>. Anonymous callers receive the publicly-safe subset of fields needed to render the landing page (product name, logo, seller name, status, tier). Authenticated callers authorized to claim through an open allowlist or a verified-email match additionally receive entitled pre-fill values. Customer resolve never returns seller owner metadata or the configured email allowlist. Authenticated callers whose email is not on a configured allowlist receive 403.
Query Parameters
Offer short hash from the customer-clicked URL
1 - 64Response
Offer resolved
Offer ID
1 - 568-char base62 code that appears in the customer-clicked URL /i/<short_hash>
"aB3xK9pQ"
Package ID
1 - 54Package version ID — pinned at create time
1 - 55Computed lifecycle status — never set directly; derived from row state.
active, archived, expired, redeemed Unix timestamp (seconds)
x >= 0Workspace ID
1 - 53Optional workspace that receives the offer outcome when visible to the caller
1 - 53User ID of the seller who issued the offer
Product ID
1 - 55JSON Schema 2020-12 with x-ui extensions for the pinned package version. Present on customer resolve responses so the install wizard can render the configure step.
Empty / omitted = anyone authed can claim. Non-empty = the customer's verified email must match. Returned on seller-authorized reads, never on customer resolve.
Seller pre-fills keyed by package input-schema property name. Customer resolve returns them only to authenticated authorized callers; values marked x-ui.sensitive are returned as redacted markers, never plaintext.
Seller-maintained customer context captured when the offer is created. Never returned by customer resolve.
Seller-only internal context. Never returned by customer resolve.
Suggested billing tier
Region pin
1 - 54Cluster pin
1 - 54Offer Channel that resolved private-offer policy for this offer
1 - 54Customer commercial path requested for an offer. paid routes through checkout when policy requires it; non_billable_test creates a non-billable test offer when policy allows it.
paid, non_billable_test not_required, pending, approved, rejected Unix timestamp (seconds)
x >= 0Per-redemption order TTL in minutes. Defaults to 120; capped at 1440 (24h).
x <= 1440x >= 0Unix timestamp (seconds)
x >= 0Unix timestamp (seconds)
x >= 0Display name of the offered product
Logo or icon URL for the customer landing page
Display name of the seller who issued this offer