{"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"},"xApiKey":{"in":"header","name":"x-api-key","type":"apiKey"}}},"info":{"description":"Scene public API for external storefronts.","title":"Scene Public API","version":"1.0.0"},"security":[{"bearerAuth":[]},{"xApiKey":[]}],"servers":[{"description":"Production","url":"https://api.mesh.ing"}],"openapi":"3.1.1","paths":{"/v1/orders/{orderId}/confirm":{"post":{"operationId":"orders.confirm","summary":"Confirm order","description":"Confirm an order after an external payment is attested as paid and Mesh issues the ticket.","tags":["orders"],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"payment":{"type":"object","properties":{"amountPaid":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"const":"USD"},"externalPaymentId":{"type":"string","minLength":1},"paidAt":{"type":"string","format":"date-time"},"provider":{"enum":["blackbird_pay"]},"status":{"const":"paid"},"type":{"const":"external"}},"required":["amountPaid","currency","externalPaymentId","paidAt","provider","status","type"]}},"required":["payment"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cart":{"type":"object","properties":{"breakdown":{"type":"object","properties":{"fees":{"type":"object","properties":{"processingFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"protocolFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"referrerFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"vendorFee":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["processingFee","protocolFee","referrerFee","total","vendorFee"]},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"taxes":{"type":"object","properties":{"salesTax":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["salesTax","total"]},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["fees","subtotal","taxes","total"]},"currency":{"const":"USD"},"fees":{"type":"integer","minimum":0,"maximum":9007199254740991},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["currency","fees","subtotal","tax","total"]},"items":{"type":"array","minItems":1,"items":{"type":"object","properties":{"label":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":100},"requiredParentTierId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"slotId":{"type":"string","minLength":1},"startsAt":{"type":"string","format":"date-time"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"unitAmount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","quantity","requiredParentTierId","slotId","startsAt","subtotal","unitAmount"]}},"orderId":{"type":"string","minLength":1},"slot":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"startsAt":{"type":"string","format":"date-time"}},"required":["id","label","startsAt"]},"status":{"enum":["payment_pending","confirmed","fulfillment_pending","failed","expired"]},"ticket":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"ticketCode":{"type":"string","minLength":1},"walletPassUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","ticketCode","walletPassUrl"]},{"type":"null"}]},"type":{"enum":["reserved","rsvp"]},"user":{"type":"object","properties":{"email":{"type":"string","maxLength":255,"format":"email"},"firstName":{"type":"string","minLength":1,"maxLength":255},"lastName":{"type":"string","minLength":1,"maxLength":255},"phone":{"type":"string","minLength":1,"maxLength":64,"pattern":"^\\+[1-9]\\d{1,14}$"}},"required":["email","firstName","lastName","phone"]}},"required":["cart","items","orderId","slot","status","ticket","type","user"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"403":{"description":"403","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"404":{"description":"404","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"409":{"description":"409","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"422":{"description":"422","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}}}}},"/v1/cart-url":{"post":{"operationId":"storefront.createCartUrl","summary":"Create a hosted cart URL","description":"Create a deterministic hosted storefront URL for selected access assets.","tags":["storefront"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discountCode":{"type":"string","minLength":1},"eventId":{"type":"string","minLength":1},"items":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":9007199254740991},"saleKeyId":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"}},"required":["quantity","saleKeyId"]}},"referrer":{"type":"string","maxLength":500},"utm":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","maxLength":500}}},"required":["eventId","items"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"absoluteCheckoutUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"checkoutUrl":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":9007199254740991},"saleKeyId":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"tierId":{"type":"string"},"tokenId":{"type":"string","pattern":"^\\d+$"}},"required":["label","quantity","saleKeyId","tierId","tokenId"]}},"warnings":{"type":"array","items":{"type":"string"}}},"required":["absoluteCheckoutUrl","checkoutUrl","items","warnings"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"403":{"description":"403","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"404":{"description":"404","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"409":{"description":"409","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"422":{"description":"422","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}}}}},"/v1/events/{eventId}/orders":{"post":{"operationId":"orders.create","summary":"Create order","description":"Create a reserved external-payment order or an immediate no-payment RSVP order.","tags":["orders"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":50},"slotId":{"type":"string","minLength":1}},"required":["quantity","slotId"]}},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"default":{}},"quantity":{"type":"integer","minimum":1,"maximum":50},"slotId":{"type":"string","minLength":1},"user":{"type":"object","properties":{"email":{"type":"string","maxLength":255,"format":"email"},"firstName":{"type":"string","minLength":1,"maxLength":255},"lastName":{"type":"string","minLength":1,"maxLength":255},"phone":{"type":"string","minLength":1,"maxLength":64,"pattern":"^\\+[1-9]\\d{1,14}$"}},"required":["email","firstName","lastName","phone"]},"payment":{"type":"object","properties":{"provider":{"enum":["blackbird_pay"]},"type":{"const":"external"}},"required":["provider","type"]},"reservation":{"type":"object","properties":{"ttlSeconds":{"type":"integer","minimum":60,"maximum":1800}}},"type":{"const":"reserved"}},"required":["user","payment","type"]},{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":50},"slotId":{"type":"string","minLength":1}},"required":["quantity","slotId"]}},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"}]},"default":{}},"quantity":{"type":"integer","minimum":1,"maximum":50},"slotId":{"type":"string","minLength":1},"user":{"type":"object","properties":{"email":{"type":"string","maxLength":255,"format":"email"},"firstName":{"type":"string","minLength":1,"maxLength":255},"lastName":{"type":"string","minLength":1,"maxLength":255},"phone":{"type":"string","minLength":1,"maxLength":64,"pattern":"^\\+[1-9]\\d{1,14}$"}},"required":["email","firstName","lastName","phone"]},"payment":{"not":{}},"reservation":{"not":{}},"type":{"const":"rsvp"}},"required":["user","type"],"additionalProperties":false}]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"cart":{"type":"object","properties":{"breakdown":{"type":"object","properties":{"fees":{"type":"object","properties":{"processingFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"protocolFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"referrerFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"vendorFee":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["processingFee","protocolFee","referrerFee","total","vendorFee"]},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"taxes":{"type":"object","properties":{"salesTax":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["salesTax","total"]},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["fees","subtotal","taxes","total"]},"currency":{"const":"USD"},"fees":{"type":"integer","minimum":0,"maximum":9007199254740991},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["currency","fees","subtotal","tax","total"]},"items":{"type":"array","minItems":1,"items":{"type":"object","properties":{"label":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":100},"requiredParentTierId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"slotId":{"type":"string","minLength":1},"startsAt":{"type":"string","format":"date-time"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"unitAmount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","quantity","requiredParentTierId","slotId","startsAt","subtotal","unitAmount"]}},"orderId":{"type":"string","minLength":1},"payment":{"type":"object","properties":{"provider":{"enum":["blackbird_pay"]},"type":{"const":"external"}},"required":["provider","type"]},"reservation":{"type":"object","properties":{"expiresAt":{"type":"string","format":"date-time"},"id":{"type":"string","minLength":1}},"required":["expiresAt","id"]},"slot":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"startsAt":{"type":"string","format":"date-time"}},"required":["id","label","startsAt"]},"status":{"const":"payment_pending"},"type":{"const":"reserved"}},"required":["cart","items","orderId","payment","reservation","slot","status","type"]},{"type":"object","properties":{"cart":{"type":"object","properties":{"breakdown":{"type":"object","properties":{"fees":{"type":"object","properties":{"processingFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"protocolFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"referrerFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"vendorFee":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["processingFee","protocolFee","referrerFee","total","vendorFee"]},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"taxes":{"type":"object","properties":{"salesTax":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["salesTax","total"]},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["fees","subtotal","taxes","total"]},"currency":{"const":"USD"},"fees":{"type":"integer","minimum":0,"maximum":9007199254740991},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["currency","fees","subtotal","tax","total"]},"items":{"type":"array","minItems":1,"items":{"type":"object","properties":{"label":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":100},"requiredParentTierId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"slotId":{"type":"string","minLength":1},"startsAt":{"type":"string","format":"date-time"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"unitAmount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","quantity","requiredParentTierId","slotId","startsAt","subtotal","unitAmount"]}},"orderId":{"type":"string","minLength":1},"slot":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"startsAt":{"type":"string","format":"date-time"}},"required":["id","label","startsAt"]},"status":{"enum":["confirmed","fulfillment_pending","failed"]},"ticket":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"ticketCode":{"type":"string","minLength":1},"walletPassUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","ticketCode","walletPassUrl"]},{"type":"null"}]},"type":{"const":"rsvp"},"user":{"type":"object","properties":{"email":{"type":"string","maxLength":255,"format":"email"},"firstName":{"type":"string","minLength":1,"maxLength":255},"lastName":{"type":"string","minLength":1,"maxLength":255},"phone":{"type":"string","minLength":1,"maxLength":64,"pattern":"^\\+[1-9]\\d{1,14}$"}},"required":["email","firstName","lastName","phone"]}},"required":["cart","items","orderId","slot","status","ticket","type","user"]}]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"403":{"description":"403","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"404":{"description":"404","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"409":{"description":"409","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"422":{"description":"422","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}}}}},"/v1/orders/{orderId}":{"get":{"operationId":"orders.get","summary":"Get order","description":"Fetch the canonical order and ticket confirmation state from Mesh.","tags":["orders"],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"cart":{"type":"object","properties":{"breakdown":{"type":"object","properties":{"fees":{"type":"object","properties":{"processingFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"protocolFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"referrerFee":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"vendorFee":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["processingFee","protocolFee","referrerFee","total","vendorFee"]},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"taxes":{"type":"object","properties":{"salesTax":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["salesTax","total"]},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["fees","subtotal","taxes","total"]},"currency":{"const":"USD"},"fees":{"type":"integer","minimum":0,"maximum":9007199254740991},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"tax":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["currency","fees","subtotal","tax","total"]},"items":{"type":"array","minItems":1,"items":{"type":"object","properties":{"label":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":100},"requiredParentTierId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"slotId":{"type":"string","minLength":1},"startsAt":{"type":"string","format":"date-time"},"subtotal":{"type":"integer","minimum":0,"maximum":9007199254740991},"unitAmount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","quantity","requiredParentTierId","slotId","startsAt","subtotal","unitAmount"]}},"orderId":{"type":"string","minLength":1},"slot":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"startsAt":{"type":"string","format":"date-time"}},"required":["id","label","startsAt"]},"status":{"enum":["payment_pending","confirmed","fulfillment_pending","failed","expired"]},"ticket":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1},"ticketCode":{"type":"string","minLength":1},"walletPassUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"required":["id","ticketCode","walletPassUrl"]},{"type":"null"}]},"type":{"enum":["reserved","rsvp"]},"user":{"type":"object","properties":{"email":{"type":"string","maxLength":255,"format":"email"},"firstName":{"type":"string","minLength":1,"maxLength":255},"lastName":{"type":"string","minLength":1,"maxLength":255},"phone":{"type":"string","minLength":1,"maxLength":64,"pattern":"^\\+[1-9]\\d{1,14}$"}},"required":["email","firstName","lastName","phone"]}},"required":["cart","items","orderId","slot","status","ticket","type","user"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"403":{"description":"403","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"404":{"description":"404","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"409":{"description":"409","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"422":{"description":"422","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}}}}},"/v1/events/{eventId}/prices":{"get":{"operationId":"storefront.listEventPrices","summary":"List event prices","description":"List sellable prices for an event.","tags":["storefront"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"availability":{"type":"object","properties":{"activeTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxPrice":{"anyOf":[{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"soldOutTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["activeTierCount","maxPrice","minPrice","remainingQuantity","soldOutTierCount","totalTierCount"]},"contractAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"display":{"type":"object","properties":{"accentLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"dateLabel":{"type":"string"},"headline":{"type":"string"},"imageAlt":{"type":"string"},"numberLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"shortDateLabel":{"type":"string"},"venueLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["accentLabel","dateLabel","headline","imageAlt","numberLabel","shortDateLabel","venueLabel"]},"eventType":{"enum":["RSVP","TICKETED"]},"id":{"type":"string"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"formattedAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"enum":["physical","virtual"]},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["address","formattedAddress","kind","name","url"]},{"type":"null"}]},"sceneId":{"type":"string"},"schedule":{"type":"object","properties":{"endTime":{"type":"string","pattern":"^\\d+$"},"startTime":{"type":"string","pattern":"^\\d+$"},"timezone":{"type":"string"}},"required":["endTime","startTime","timezone"]},"status":{"enum":["live","scheduled","past"]},"title":{"type":"string"}},"required":["acceptingRegistration","availability","contractAddress","description","display","eventType","id","imageUrl","location","sceneId","schedule","status","title"]},"prices":{"type":"array","items":{"type":"object","properties":{"allInclusivePrice":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"contractAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"display":{"type":"object","properties":{"defaultSelected":{"type":"boolean"},"group":{"anyOf":[{"type":"string"},{"type":"null"}]},"sortOrder":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"visible":{"type":"boolean"}},"required":["defaultSelected","group","sortOrder","subtitle","visible"]},"eventId":{"type":"string"},"fees":{"type":"object","properties":{"processingFee":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"protocolFee":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"salesTax":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"vendorFee":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]}},"required":["processingFee","protocolFee","salesTax","vendorFee"]},"isActive":{"type":"boolean"},"label":{"type":"string"},"price":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"relationships":{"type":"object","properties":{"requiredParentTierId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["requiredParentTierId"]},"restrictions":{"type":"object","properties":{"maxQuantityPerOrder":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]},"requiresAccessCode":{"type":"boolean"}},"required":["maxQuantityPerOrder","requiresAccessCode"]},"saleKeyId":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"saleWindow":{"type":"object","properties":{"endTime":{"type":"string","pattern":"^\\d+$"},"isActive":{"type":"boolean"},"startTime":{"type":"string","pattern":"^\\d+$"}},"required":["endTime","isActive","startTime"]},"schedule":{"type":"object","properties":{"endTime":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"startTime":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"timezone":{"type":"string"}},"required":["endTime","startTime","timezone"]},"tokenId":{"type":"string","pattern":"^\\d+$"},"validityWindow":{"type":"object","properties":{"isActive":{"type":"boolean"},"validFrom":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]}},"required":["isActive","validFrom","validUntil"]},"currency":{"const":"USDC"}},"required":["allInclusivePrice","contractAddress","description","display","eventId","fees","isActive","label","price","promoCode","relationships","restrictions","saleKeyId","saleWindow","schedule","tokenId","validityWindow","currency"]}}},"required":["event","prices"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"403":{"description":"403","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"404":{"description":"404","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"409":{"description":"409","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"422":{"description":"422","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}}}}},"/v1/events":{"get":{"operationId":"storefront.listEvents","summary":"List scene events","description":"List scheduled, live, past, or all events for an authorized scene.","tags":["storefront"],"parameters":[{"name":"collaboratorGroupIds","in":"query","required":false,"schema":{"type":"array","minItems":1,"items":{"type":"string","minLength":1}},"style":"deepObject","explode":true,"allowEmptyValue":true,"allowReserved":true},{"name":"eventIds","in":"query","required":false,"schema":{"type":"array","minItems":1,"items":{"type":"string","minLength":1}},"style":"deepObject","explode":true,"allowEmptyValue":true,"allowReserved":true},{"name":"eventType","in":"query","required":false,"schema":{"enum":["RSVP","TICKETED"]},"style":"deepObject","explode":true,"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"allowEmptyValue":true,"allowReserved":true},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"default":0},"allowEmptyValue":true,"allowReserved":true},{"name":"sceneId","in":"query","required":true,"schema":{"type":"string","minLength":1},"allowEmptyValue":true,"allowReserved":true},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"const":"live"},{"const":"scheduled"},{"const":"past"},{"const":"all"}],"default":"scheduled"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"availability":{"type":"object","properties":{"activeTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxPrice":{"anyOf":[{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"soldOutTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["activeTierCount","maxPrice","minPrice","remainingQuantity","soldOutTierCount","totalTierCount"]},"contractAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"display":{"type":"object","properties":{"accentLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"dateLabel":{"type":"string"},"headline":{"type":"string"},"imageAlt":{"type":"string"},"numberLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"shortDateLabel":{"type":"string"},"venueLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["accentLabel","dateLabel","headline","imageAlt","numberLabel","shortDateLabel","venueLabel"]},"eventType":{"enum":["RSVP","TICKETED"]},"id":{"type":"string"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"formattedAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"enum":["physical","virtual"]},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["address","formattedAddress","kind","name","url"]},{"type":"null"}]},"sceneId":{"type":"string"},"schedule":{"type":"object","properties":{"endTime":{"type":"string","pattern":"^\\d+$"},"startTime":{"type":"string","pattern":"^\\d+$"},"timezone":{"type":"string"}},"required":["endTime","startTime","timezone"]},"status":{"enum":["live","scheduled","past"]},"title":{"type":"string"}},"required":["acceptingRegistration","availability","contractAddress","description","display","eventType","id","imageUrl","location","sceneId","schedule","status","title"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":9007199254740991},"nextOffset":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","nextOffset","offset"]}},"required":["events","pagination"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"403":{"description":"403","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"404":{"description":"404","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"409":{"description":"409","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"422":{"description":"422","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}}}}},"/v1/events/{eventId}/tiers":{"get":{"operationId":"storefront.listEventTiers","summary":"List event tiers","description":"List sellable tiers for an event.","tags":["storefront"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"availability":{"type":"object","properties":{"activeTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxPrice":{"anyOf":[{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},{"type":"null"}]},"minPrice":{"anyOf":[{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"soldOutTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalTierCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["activeTierCount","maxPrice","minPrice","remainingQuantity","soldOutTierCount","totalTierCount"]},"contractAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"display":{"type":"object","properties":{"accentLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"dateLabel":{"type":"string"},"headline":{"type":"string"},"imageAlt":{"type":"string"},"numberLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"shortDateLabel":{"type":"string"},"venueLabel":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["accentLabel","dateLabel","headline","imageAlt","numberLabel","shortDateLabel","venueLabel"]},"eventType":{"enum":["RSVP","TICKETED"]},"id":{"type":"string"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"formattedAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"anyOf":[{"enum":["physical","virtual"]},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["address","formattedAddress","kind","name","url"]},{"type":"null"}]},"sceneId":{"type":"string"},"schedule":{"type":"object","properties":{"endTime":{"type":"string","pattern":"^\\d+$"},"startTime":{"type":"string","pattern":"^\\d+$"},"timezone":{"type":"string"}},"required":["endTime","startTime","timezone"]},"status":{"enum":["live","scheduled","past"]},"title":{"type":"string"}},"required":["acceptingRegistration","availability","contractAddress","description","display","eventType","id","imageUrl","location","sceneId","schedule","status","title"]},"tiers":{"type":"array","items":{"type":"object","properties":{"allInclusivePrice":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"contractAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"display":{"type":"object","properties":{"defaultSelected":{"type":"boolean"},"group":{"anyOf":[{"type":"string"},{"type":"null"}]},"sortOrder":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"visible":{"type":"boolean"}},"required":["defaultSelected","group","sortOrder","subtitle","visible"]},"eventId":{"type":"string"},"fees":{"type":"object","properties":{"processingFee":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"protocolFee":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"salesTax":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"vendorFee":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]}},"required":["processingFee","protocolFee","salesTax","vendorFee"]},"id":{"type":"string"},"isActive":{"type":"boolean"},"isSoldOut":{"type":"boolean"},"label":{"type":"string"},"price":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"type":"object","properties":{"label":{"type":"string"},"maxSupply":{"type":"string","pattern":"^\\d+$"},"remaining":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"remainingNumber":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"saleQuantity":{"type":"string","pattern":"^\\d+$"},"saleRemaining":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"tokenRemaining":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"totalMinted":{"type":"string","pattern":"^\\d+$"}},"required":["label","maxSupply","remaining","remainingNumber","saleQuantity","saleRemaining","soldQuantity","tokenRemaining","totalMinted"]},"relationships":{"type":"object","properties":{"requiredParentTierId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["requiredParentTierId"]},"restrictions":{"type":"object","properties":{"maxQuantityPerOrder":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]},"requiresAccessCode":{"type":"boolean"}},"required":["maxQuantityPerOrder","requiresAccessCode"]},"saleKeyId":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"saleWindow":{"type":"object","properties":{"endTime":{"type":"string","pattern":"^\\d+$"},"isActive":{"type":"boolean"},"startTime":{"type":"string","pattern":"^\\d+$"}},"required":["endTime","isActive","startTime"]},"schedule":{"type":"object","properties":{"endTime":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"startTime":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"timezone":{"type":"string"}},"required":["endTime","startTime","timezone"]},"tokenId":{"type":"string","pattern":"^\\d+$"},"validityWindow":{"type":"object","properties":{"isActive":{"type":"boolean"},"validFrom":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]}},"required":["isActive","validFrom","validUntil"]}},"required":["allInclusivePrice","contractAddress","description","display","eventId","fees","id","isActive","isSoldOut","label","price","promoCode","quantity","relationships","restrictions","saleKeyId","saleWindow","schedule","tokenId","validityWindow"]}}},"required":["event","tiers"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"403":{"description":"403","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"404":{"description":"404","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"409":{"description":"409","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}},"422":{"description":"422","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"}},"required":["error"],"type":"object"}}}}}}}}}