{"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/events/{eventId}/archive":{"post":{"operationId":"management.archiveEvent","summary":"Archive an event","description":"Archive a managed event and stop active sales.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/{tierId}/archive":{"post":{"operationId":"management.archiveEventTier","summary":"Archive an event tier","description":"Archive a managed ticket tier and stop its active sale.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"tierId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/check-ins":{"post":{"operationId":"management.checkInEventTickets","summary":"Check in event tickets","description":"Submit selected tickets from a validated event-bound QR token for onchain check-in. Submission acceptance is not confirmation.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":256}},{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tickets":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":100},"tokenId":{"type":"string","pattern":"^\\d+$"}},"required":["quantity","tokenId"]}},"token":{"type":"string","minLength":1,"maxLength":128}},"required":["tickets","token"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"submitted"},"userOpHash":{"type":"string","minLength":66,"maxLength":66,"pattern":"^0x[0-9a-fA-F]+$"}},"required":["status","userOpHash"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/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":{"const":"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":{"answers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":256},"questionId":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":1000}},"required":["label","questionId","value"]},"default":[]},"cart":{"type":"object","properties":{"additionalFee":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"label":{"type":"string","minLength":1,"maxLength":100}},"required":["amount","label"]},{"type":"null"}]},"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"]},"discount":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"code":{"type":"string","minLength":1},"useCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["amount","code","useCount"]},{"type":"null"}],"default":null},"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"],"type":"string"},"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"],"type":"string"},"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"]}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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 hosted event or direct-checkout URL for validated access assets. Destination defaults to event.","tags":["storefront"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accessCode":{"type":"string","minLength":1,"maxLength":500},"attribution":{"type":"object","properties":{"cartId":{"type":"string","format":"uuid"},"cartRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"consentState":{"enum":["granted","denied","unknown"],"type":"string"},"utm":{"type":"object","properties":{"utm_campaign":{"type":"string","maxLength":512},"utm_content":{"type":"string","maxLength":512},"utm_id":{"type":"string","maxLength":512},"utm_medium":{"type":"string","maxLength":512},"utm_source":{"type":"string","maxLength":512},"utm_term":{"type":"string","maxLength":512}}},"visitId":{"type":"string","format":"uuid"}},"required":["visitId"]},"destination":{"enum":["event","checkout"],"type":"string","description":"Hosted URL destination. Defaults to event."},"discountCode":{"type":"string","minLength":1,"maxLength":500},"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},"returnUrl":{"type":"string","maxLength":2048,"format":"uri"},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/discount-codes":{"post":{"operationId":"management.createDiscountCode","summary":"Create a discount code","description":"Create a discount code for a managed event.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":50},"enabled":{"type":"boolean"},"maxUses":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":2147483647,"exclusiveMinimum":0},{"type":"null"}]},"minimumOrderAmountUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"tierIds":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1}},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"value":{"anyOf":[{"type":"object","properties":{"amountUsdc":{"type":"string","pattern":"^\\d+$"},"type":{"const":"fixed"}},"required":["amountUsdc","type"]},{"type":"object","properties":{"percentageBps":{"type":"integer","minimum":1,"maximum":10000},"type":{"const":"percentage"}},"required":["percentageBps","type"]}]}},"required":["code","enabled","maxUses","minimumOrderAmountUsdc","tierIds","validFrom","validUntil","value"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"discountCode":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":50},"enabled":{"type":"boolean"},"maxUses":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":2147483647,"exclusiveMinimum":0},{"type":"null"}]},"minimumOrderAmountUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"tierIds":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1}},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"value":{"anyOf":[{"type":"object","properties":{"amountUsdc":{"type":"string","pattern":"^\\d+$"},"type":{"const":"fixed"}},"required":["amountUsdc","type"]},{"type":"object","properties":{"percentageBps":{"type":"integer","minimum":1,"maximum":10000},"type":{"const":"percentage"}},"required":["percentageBps","type"]}]},"createdAt":{"type":"string","format":"date-time"},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"uses":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["code","enabled","maxUses","minimumOrderAmountUsdc","tierIds","validFrom","validUntil","value","createdAt","eventId","id","updatedAt","uses"]}},"required":["discountCode"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"}}}}}},"get":{"operationId":"management.listDiscountCodes","summary":"List discount codes","description":"List discount codes and current use counts for a managed event.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"discountCodes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":50},"enabled":{"type":"boolean"},"maxUses":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":2147483647,"exclusiveMinimum":0},{"type":"null"}]},"minimumOrderAmountUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"tierIds":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1}},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"value":{"anyOf":[{"type":"object","properties":{"amountUsdc":{"type":"string","pattern":"^\\d+$"},"type":{"const":"fixed"}},"required":["amountUsdc","type"]},{"type":"object","properties":{"percentageBps":{"type":"integer","minimum":1,"maximum":10000},"type":{"const":"percentage"}},"required":["percentageBps","type"]}]},"createdAt":{"type":"string","format":"date-time"},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"uses":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["code","enabled","maxUses","minimumOrderAmountUsdc","tierIds","validFrom","validUntil","value","createdAt","eventId","id","updatedAt","uses"]}}},"required":["discountCodes"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/scenes/{sceneId}/events":{"post":{"operationId":"management.createEvent","summary":"Create event","description":"Create a draft event for an authorized scene.","tags":["management"],"parameters":[{"name":"sceneId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":256}},{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"additionalDetails":{"type":"string","maxLength":2000},"capacity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},"customQuestions":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"type":"string","maxLength":2000},"emailSettings":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}}},"endAt":{"type":"string","format":"date-time"},"hideAddressUntilConfirmed":{"type":"boolean"},"imageUrl":{"type":"string","format":"uri"},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},"name":{"type":"string","minLength":1,"maxLength":256},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700},"requireApproval":{"type":"boolean"},"startAt":{"type":"string","format":"date-time"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"type":"integer","minimum":0,"maximum":10000},"timezone":{"type":"string","minLength":1,"maxLength":64},"visibility":{"enum":["public","private"],"type":"string"},"eventType":{"const":"RSVP"}},"required":["name","eventType"]},{"type":"object","properties":{"additionalDetails":{"type":"string","maxLength":2000},"capacity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},"customQuestions":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"type":"string","maxLength":2000},"emailSettings":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}}},"endAt":{"type":"string","format":"date-time"},"hideAddressUntilConfirmed":{"type":"boolean"},"imageUrl":{"type":"string","format":"uri"},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},"name":{"type":"string","minLength":1,"maxLength":256},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700},"requireApproval":{"type":"boolean"},"startAt":{"type":"string","format":"date-time"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"type":"integer","minimum":0,"maximum":10000},"timezone":{"type":"string","minLength":1,"maxLength":64},"visibility":{"enum":["public","private"],"type":"string"},"eventType":{"const":"TICKETED"},"ticketOrderLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},"ticketTotalLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},"tiers":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"clientReferenceId":{"type":"string","minLength":1,"maxLength":128},"description":{"type":"string","maxLength":2000},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"label":{"type":"string","minLength":1,"maxLength":256},"priceUsdc":{"type":"string","pattern":"^\\d+$"},"promoCode":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}]},"requiredParentClientReferenceId":{"anyOf":[{"type":"string","minLength":1,"maxLength":128},{"type":"null"}]},"sortOrder":{"type":"integer","minimum":0,"maximum":9007199254740991},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"totalQuantity":{"type":"string","pattern":"^[1-9]\\d*$"},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["label","priceUsdc","totalQuantity"]}}},"required":["name","eventType","tiers"]}]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"}}}}}},"get":{"operationId":"management.listManagedEvents","summary":"List managed events","description":"List draft, publishing, published, and optionally archived events for an authorized scene.","tags":["management"],"parameters":[{"name":"sceneId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"cursor","in":"query","schema":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"allowEmptyValue":true,"allowReserved":true},{"name":"includeArchived","in":"query","schema":{"anyOf":[{"type":"boolean"},{"enum":["true","false"],"type":"string"}],"default":false},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"required":["event","tiers"]}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["events","nextCursor"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/scenes/{sceneId}/event-image-uploads":{"post":{"operationId":"management.createEventImageUpload","summary":"Create event image upload","description":"Create a short-lived, size- and content-type-bound upload URL for a JPEG or PNG event cover image. Upload the image with PUT, then use imageUrl when creating or updating an event.","tags":["management"],"parameters":[{"name":"sceneId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contentLength":{"type":"integer","minimum":1,"maximum":4194304},"contentType":{"enum":["image/jpeg","image/png"],"type":"string"}},"required":["contentLength","contentType"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"expiresAt":{"type":"string","format":"date-time"},"imageUrl":{"type":"string","format":"uri"},"uploadHeaders":{"type":"object","properties":{"Content-Length":{"type":"string","pattern":"^[1-9]\\d*$"},"Content-Type":{"enum":["image/jpeg","image/png"],"type":"string"}},"required":["Content-Length","Content-Type"]},"uploadMethod":{"const":"PUT"},"uploadUrl":{"type":"string","format":"uri"}},"required":["expiresAt","imageUrl","uploadHeaders","uploadMethod","uploadUrl"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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":{"post":{"operationId":"management.createEventTier","summary":"Create an event tier","description":"Create a ticket tier for a managed ticketed event.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":256}},{"name":"idempotency-key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"description":{"type":"string","maxLength":2000},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"label":{"type":"string","minLength":1,"maxLength":256},"priceUsdc":{"type":"string","pattern":"^\\d+$"},"promoCode":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"sortOrder":{"type":"integer","minimum":0,"maximum":9007199254740991},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"totalQuantity":{"type":"string","pattern":"^[1-9]\\d*$"},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["label","priceUsdc","totalQuantity"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"}}}}}},"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]+$"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"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"],"type":"string"},"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":"string"},{"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"],"type":"string"},"title":{"type":"string"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["acceptingRegistration","availability","contractAddress","customQuestions","description","display","eventType","id","imageUrl","location","sceneId","schedule","status","title","videoUrl"]},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/analytics/handoff":{"post":{"operationId":"analytics.createHandoffToken","summary":"Mint handoff token","description":"Mint a short-lived cross-domain handoff token for a known visit. Exchanged on the Mesh hosted domain for a first-party cookie.","tags":["analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sceneId":{"type":"string","minLength":1,"maxLength":64},"visitId":{"type":"string","format":"uuid"}},"required":["visitId"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1}},"required":["token"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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":{"accessCode":{"type":"string","minLength":1,"maxLength":500},"answers":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"questionId":{"type":"string","minLength":1},"value":{"type":"string","minLength":1,"maxLength":1000}},"required":["questionId","value"]}},"discountCode":{"type":"string","minLength":1,"maxLength":50},"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"]},"additionalFee":{"type":"object","properties":{"amountUSDC":{"type":"string","pattern":"^\\d+$"},"label":{"type":"string","minLength":1,"maxLength":100}},"required":["amountUSDC"]},"payment":{"type":"object","properties":{"provider":{"const":"blackbird_pay"},"type":{"const":"external"}},"required":["provider","type"]},"referrerAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"reservation":{"type":"object","properties":{"ttlSeconds":{"type":"integer","minimum":60,"maximum":1800}}},"type":{"const":"reserved"}},"required":["user","payment","type"]},{"type":"object","properties":{"accessCode":{"type":"string","minLength":1,"maxLength":500},"answers":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"questionId":{"type":"string","minLength":1},"value":{"type":"string","minLength":1,"maxLength":1000}},"required":["questionId","value"]}},"discountCode":{"type":"string","minLength":1,"maxLength":50},"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"]},"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":{"additionalFee":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"label":{"type":"string","minLength":1,"maxLength":100}},"required":["amount","label"]},{"type":"null"}]},"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"]},"discount":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"code":{"type":"string","minLength":1},"useCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["amount","code","useCount"]},{"type":"null"}],"default":null},"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":{"const":"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":{"additionalFee":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"label":{"type":"string","minLength":1,"maxLength":100}},"required":["amount","label"]},{"type":"null"}]},"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"]},"discount":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"code":{"type":"string","minLength":1},"useCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["amount","code","useCount"]},{"type":"null"}],"default":null},"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"],"type":"string"},"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"]}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"}}}}}},"get":{"operationId":"orders.list","summary":"List event orders","description":"List orders created through the Storefront API for an authorized event, newest first.","tags":["orders"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"default":0},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"answers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":256},"questionId":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":1000}},"required":["label","questionId","value"]},"default":[]},"cart":{"type":"object","properties":{"additionalFee":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"label":{"type":"string","minLength":1,"maxLength":100}},"required":["amount","label"]},{"type":"null"}]},"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"]},"discount":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"code":{"type":"string","minLength":1},"useCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["amount","code","useCount"]},{"type":"null"}],"default":null},"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"],"type":"string"},"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"],"type":"string"},"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"]},"createdAt":{"type":"string","format":"date-time"}},"required":["cart","items","orderId","slot","status","ticket","type","user","createdAt"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","offset","total"]}},"required":["orders","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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/scenes":{"post":{"operationId":"management.createScene","summary":"Create a scene","description":"Provision a scene for the authenticated management client.","tags":["management"],"parameters":[{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","maxLength":256,"format":"uri"},{"type":"null"}]},"defaultReferrerAddress":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}]},"externalReference":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"name":{"type":"string","minLength":1,"maxLength":256}},"required":["externalReference","name"]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"scene":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultReferrerAddress":{"anyOf":[{},{"type":"null"}],"default":null},"externalReference":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["avatarUrl","externalReference","id","name","slug"]}},"required":["scene"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/discount-codes/{codeId}":{"delete":{"operationId":"management.deleteDiscountCode","summary":"Delete a discount code","description":"Delete a discount code from a managed event.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true}},"required":["success"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"}}}}}},"patch":{"operationId":"management.updateDiscountCode","summary":"Update a discount code","description":"Update a discount code for a managed event.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"codeId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":50},"enabled":{"type":"boolean"},"maxUses":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":2147483647,"exclusiveMinimum":0},{"type":"null"}]},"minimumOrderAmountUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"tierIds":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1}},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"value":{"anyOf":[{"type":"object","properties":{"amountUsdc":{"type":"string","pattern":"^\\d+$"},"type":{"const":"fixed"}},"required":["amountUsdc","type"]},{"type":"object","properties":{"percentageBps":{"type":"integer","minimum":1,"maximum":10000},"type":{"const":"percentage"}},"required":["percentageBps","type"]}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"discountCode":{"type":"object","properties":{"code":{"type":"string","minLength":1,"maxLength":50},"enabled":{"type":"boolean"},"maxUses":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":2147483647,"exclusiveMinimum":0},{"type":"null"}]},"minimumOrderAmountUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"tierIds":{"type":"array","maxItems":100,"items":{"type":"string","minLength":1}},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"value":{"anyOf":[{"type":"object","properties":{"amountUsdc":{"type":"string","pattern":"^\\d+$"},"type":{"const":"fixed"}},"required":["amountUsdc","type"]},{"type":"object","properties":{"percentageBps":{"type":"integer","minimum":1,"maximum":10000},"type":{"const":"percentage"}},"required":["percentageBps","type"]}]},"createdAt":{"type":"string","format":"date-time"},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"uses":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["code","enabled","maxUses","minimumOrderAmountUsdc","tierIds","validFrom","validUntil","value","createdAt","eventId","id","updatedAt","uses"]}},"required":["discountCode"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}":{"get":{"operationId":"management.getEvent","summary":"Get an event","description":"Get a managed event and its ticket tiers.","tags":["management"],"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"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"}}}}}},"patch":{"operationId":"management.updateEvent","summary":"Update an event","description":"Update managed event metadata and schedule.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"additionalDetails":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"customQuestions":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}]},"emailSettings":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}}},"endAt":{"type":"string","format":"date-time"},"hideAddressUntilConfirmed":{"type":"boolean"},"imageUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"name":{"type":"string","minLength":1,"maxLength":256},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700},"requireApproval":{"type":"boolean"},"startAt":{"type":"string","format":"date-time"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}]},"ticketOrderLimit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},{"type":"null"}]},"ticketTotalLimit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},{"type":"null"}]},"timezone":{"type":"string","minLength":1,"maxLength":64},"videoUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/analytics":{"get":{"operationId":"analytics.getEvent","summary":"Get event analytics","description":"Unified human-only metrics across Mesh and storefronts. Requires server-side analytics.read permission. Data is asynchronously ingested; monetary strings use USDC base units (6 decimals). A storefront filter narrows otherwise unified totals.","tags":["analytics"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true},{"name":"referrer","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"storefront","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmCampaign","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmMedium","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmSource","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"conversion":{"type":"object","properties":{"grossConversions":{"type":"number"},"grossRevenueUsdc":{"type":"string"},"netConversions":{"type":"number"},"netRevenueUsdc":{"type":"string"}},"required":["grossConversions","grossRevenueUsdc","netConversions","netRevenueUsdc"]},"steps":{"type":"array","items":{"type":"object","properties":{"eventName":{"type":"string"},"events":{"type":"number"},"visits":{"type":"number"}},"required":["eventName","events","visits"]}},"timeseries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"eventName":{"type":"string"},"events":{"type":"number"},"visits":{"type":"number"}},"required":["bucket","eventName","events","visits"]}},"money":{"type":"object","properties":{"currency":{"const":"USDC"},"decimals":{"const":6}},"required":["currency","decimals"]}},"required":["conversion","steps","timeseries","money"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/analytics/breakdown":{"get":{"operationId":"analytics.getEventBreakdown","summary":"Get event analytics breakdown","description":"Unified human-only metrics across Mesh and storefronts. Requires server-side analytics.read permission. Data is asynchronously ingested; monetary strings use USDC base units (6 decimals). A storefront filter narrows otherwise unified totals.","tags":["analytics"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true},{"name":"referrer","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"storefront","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmCampaign","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmMedium","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmSource","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"groupBy","in":"query","required":true,"schema":{"enum":["browser","city","country","device","os","referrer","region","sale_key_id","storefront","trigger","utm_campaign","utm_medium","utm_source"],"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"events":{"type":"number"},"groupBy":{"type":"string"},"groupByValue":{"type":"string"},"visits":{"type":"number"}},"required":["events","groupBy","groupByValue","visits"]}}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/analytics/tiers":{"get":{"operationId":"analytics.getEventTiers","summary":"Get event tier analytics","description":"Unified human-only metrics across Mesh and storefronts. Requires server-side analytics.read permission. Data is asynchronously ingested; monetary strings use USDC base units (6 decimals). A storefront filter narrows otherwise unified totals.","tags":["analytics"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true},{"name":"referrer","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"storefront","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmCampaign","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmMedium","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmSource","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"money":{"type":"object","properties":{"currency":{"const":"USDC"},"decimals":{"const":6}},"required":["currency","decimals"]},"tiers":{"type":"array","items":{"type":"object","properties":{"carts":{"type":"number"},"deleted":{"type":"boolean"},"grossRevenueUsdc":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"netRevenueUsdc":{"type":"string"},"orders":{"type":"number"},"saleKeyId":{"type":"string"},"tierViews":{"type":"number"}},"required":["carts","deleted","grossRevenueUsdc","label","netRevenueUsdc","orders","saleKeyId","tierViews"]}}},"required":["money","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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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":{"answers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":256},"questionId":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":1000}},"required":["label","questionId","value"]},"default":[]},"cart":{"type":"object","properties":{"additionalFee":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"label":{"type":"string","minLength":1,"maxLength":100}},"required":["amount","label"]},{"type":"null"}]},"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"]},"discount":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"code":{"type":"string","minLength":1},"useCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["amount","code","useCount"]},{"type":"null"}],"default":null},"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"],"type":"string"},"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"],"type":"string"},"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"]}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/scenes/{sceneId}":{"get":{"operationId":"storefront.getScene","summary":"Get scene branding","description":"Get storefront branding for an authorized scene: name, slug, avatar, and theme tokens.","tags":["storefront"],"parameters":[{"name":"sceneId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"scene":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultReferrerAddress":{"anyOf":[{},{"type":"null"}],"default":null},"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"theme":{"type":"object","properties":{"colors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"css":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["colors","css"]}},"required":["avatarUrl","id","name","slug","theme"]}},"required":["scene"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"}}}}}},"patch":{"operationId":"management.updateScene","summary":"Update a scene","description":"Update mutable fields on an authorized scene.","tags":["management"],"parameters":[{"name":"sceneId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","maxLength":256,"format":"uri"},{"type":"null"}]},"defaultReferrerAddress":{"anyOf":[{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},{"type":"null"}]},"name":{"type":"string","minLength":1,"maxLength":256}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"scene":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultReferrerAddress":{"anyOf":[{},{"type":"null"}],"default":null},"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"theme":{"type":"object","properties":{"colors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"css":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["colors","css"]}},"required":["avatarUrl","id","name","slug","theme"]}},"required":["scene"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/scenes/{sceneId}/analytics":{"get":{"operationId":"analytics.getScene","summary":"Get scene analytics","description":"Unified human-only metrics across Mesh and storefronts. Requires server-side analytics.read permission. Data is asynchronously ingested; monetary strings use USDC base units (6 decimals). A storefront filter narrows otherwise unified totals.","tags":["analytics"],"parameters":[{"name":"sceneId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true},{"name":"referrer","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"storefront","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmCampaign","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmMedium","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmSource","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"conversion":{"type":"object","properties":{"grossConversions":{"type":"number"},"grossRevenueUsdc":{"type":"string"},"netConversions":{"type":"number"},"netRevenueUsdc":{"type":"string"}},"required":["grossConversions","grossRevenueUsdc","netConversions","netRevenueUsdc"]},"steps":{"type":"array","items":{"type":"object","properties":{"eventName":{"type":"string"},"events":{"type":"number"},"visits":{"type":"number"}},"required":["eventName","events","visits"]}},"timeseries":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string"},"eventName":{"type":"string"},"events":{"type":"number"},"visits":{"type":"number"}},"required":["bucket","eventName","events","visits"]}},"money":{"type":"object","properties":{"currency":{"const":"USDC"},"decimals":{"const":6}},"required":["currency","decimals"]}},"required":["conversion","steps","timeseries","money"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/scenes/{sceneId}/analytics/breakdown":{"get":{"operationId":"analytics.getSceneBreakdown","summary":"Get scene analytics breakdown","description":"Unified human-only metrics across Mesh and storefronts. Requires server-side analytics.read permission. Data is asynchronously ingested; monetary strings use USDC base units (6 decimals). A storefront filter narrows otherwise unified totals.","tags":["analytics"],"parameters":[{"name":"sceneId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true},{"name":"referrer","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"storefront","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmCampaign","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmMedium","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmSource","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"groupBy","in":"query","required":true,"schema":{"enum":["browser","city","country","device","os","referrer","region","sale_key_id","storefront","trigger","utm_campaign","utm_medium","utm_source"],"type":"string"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"events":{"type":"number"},"groupBy":{"type":"string"},"groupByValue":{"type":"string"},"visits":{"type":"number"}},"required":["events","groupBy","groupByValue","visits"]}}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/scenes/{sceneId}/analytics/tiers":{"get":{"operationId":"analytics.getSceneTiers","summary":"Get scene tier analytics","description":"Unified human-only metrics across Mesh and storefronts. Requires server-side analytics.read permission. Data is asynchronously ingested; monetary strings use USDC base units (6 decimals). A storefront filter narrows otherwise unified totals.","tags":["analytics"],"parameters":[{"name":"sceneId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":64}},{"name":"country","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true},{"name":"referrer","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"allowEmptyValue":true,"allowReserved":true},{"name":"storefront","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmCampaign","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmMedium","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"utmSource","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"money":{"type":"object","properties":{"currency":{"const":"USDC"},"decimals":{"const":6}},"required":["currency","decimals"]},"tiers":{"type":"array","items":{"type":"object","properties":{"carts":{"type":"number"},"deleted":{"type":"boolean"},"grossRevenueUsdc":{"type":"string"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"netRevenueUsdc":{"type":"string"},"orders":{"type":"number"},"saleKeyId":{"type":"string"},"tierViews":{"type":"number"}},"required":["carts","deleted","grossRevenueUsdc","label","netRevenueUsdc","orders","saleKeyId","tierViews"]}}},"required":["money","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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/scenes/by-external-reference/{externalReference}":{"get":{"operationId":"management.getSceneByExternalReference","summary":"Get a scene by external reference","description":"Get a completed, active scene by its partner-scoped external reference.","tags":["management"],"parameters":[{"name":"externalReference","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"scene":{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"defaultReferrerAddress":{"anyOf":[{},{"type":"null"}],"default":null},"externalReference":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["avatarUrl","externalReference","id","name","slug"]}},"required":["scene"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/attendees":{"get":{"operationId":"management.listEventAttendees","summary":"List event attendees","description":"List ticket holders and their successful-order registration answers for a managed event.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"allowEmptyValue":true,"allowReserved":true},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":9007199254740991,"default":0},"allowEmptyValue":true,"allowReserved":true},{"name":"search","in":"query","schema":{"type":"string","minLength":1,"maxLength":256},"allowEmptyValue":true,"allowReserved":true},{"name":"sort","in":"query","schema":{"enum":["alphabetical","status","registeredAt"],"type":"string","default":"registeredAt"},"allowEmptyValue":true,"allowReserved":true},{"name":"sortDirection","in":"query","schema":{"enum":["asc","desc"],"type":"string","default":"desc"},"allowEmptyValue":true,"allowReserved":true},{"name":"status","in":"query","schema":{"enum":["all","going","checked_in"],"type":"string","default":"all"},"allowEmptyValue":true,"allowReserved":true},{"name":"ticketType","in":"query","schema":{"type":"string","pattern":"^\\d+$"},"allowEmptyValue":true,"allowReserved":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attendees":{"type":"array","items":{"type":"object","properties":{"checkedIn":{"type":"boolean"},"checkedInQuantity":{"type":"string","pattern":"^\\d+$"},"emailAddress":{"anyOf":[{"type":"string"},{"type":"null"}]},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}]},"registeredAt":{"type":"string","format":"date-time"},"registrations":{"type":"array","items":{"type":"object","properties":{"answers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":256},"questionId":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"string","minLength":1,"maxLength":1000}},"required":["label","questionId","value"]}},"createdAt":{"type":"string","format":"date-time"},"orderId":{"type":"string","minLength":1}},"required":["answers","createdAt","orderId"]}},"ticketQuantity":{"type":"string","pattern":"^\\d+$"},"tickets":{"type":"array","items":{"type":"object","properties":{"checkedIn":{"type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"type":"string","pattern":"^\\d+$"},"tokenId":{"type":"string","pattern":"^\\d+$"},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["checkedIn","label","quantity","tokenId","validFrom","validUntil"]}},"walletAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["checkedIn","checkedInQuantity","emailAddress","firstName","lastName","registeredAt","registrations","ticketQuantity","tickets","walletAddress"]}},"facets":{"type":"object","properties":{"statuses":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"ticketTypes":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["statuses","ticketTypes"]},"pagination":{"type":"object","properties":{"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},"offset":{"type":"integer","minimum":0,"maximum":9007199254740991},"total":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["limit","offset","total"]}},"required":["attendees","facets","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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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]+$"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"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"],"type":"string"},"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":"string"},{"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"],"type":"string"},"title":{"type":"string"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["acceptingRegistration","availability","contractAddress","customQuestions","description","display","eventType","id","imageUrl","location","sceneId","schedule","status","title","videoUrl"]},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"],"type":"string"},"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]+$"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"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"],"type":"string"},"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":"string"},{"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"],"type":"string"},"title":{"type":"string"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["acceptingRegistration","availability","contractAddress","customQuestions","description","display","eventType","id","imageUrl","location","sceneId","schedule","status","title","videoUrl"]}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/publish":{"post":{"operationId":"management.publishEvent","summary":"Publish an event","description":"Queue publication of a draft event. Publication and onchain setup complete asynchronously.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}},"publishStatus":{"enum":["already_published","queued"],"type":"string"}},"required":["event","tiers","publishStatus"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/access-code/resolve":{"post":{"operationId":"storefront.resolveAccessCode","summary":"Resolve access-code tiers","description":"Resolve storefront-safe tiers unlocked by an access code without exposing the code or creating a cart.","tags":["storefront"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accessCode":{"type":"string","minLength":1,"maxLength":500}},"required":["accessCode"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"accessCode":{"type":"object","properties":{"status":{"enum":["applied","invalid","expired","inactive","not_applicable","not_supplied"],"type":"string"}},"required":["status"]},"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]+$"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string"},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"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"],"type":"string"},"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":"string"},{"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"],"type":"string"},"title":{"type":"string"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["acceptingRegistration","availability","contractAddress","customQuestions","description","display","eventType","id","imageUrl","location","sceneId","schedule","status","title","videoUrl"]},"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":["accessCode","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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/analytics/track":{"post":{"operationId":"analytics.trackEvent","summary":"Track storefront event","description":"Accept a browser attribution event for durable async delivery. Returns after durable enqueue, not after Tinybird ingest.","tags":["analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cartId":{"type":"string","format":"uuid"},"cartRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"eventContractId":{"type":"string","minLength":1,"maxLength":64},"eventId":{"type":"string","format":"uuid"},"eventName":{"enum":["visit.started","event.viewed","tier.viewed","cart.updated","cart.url_created","checkout.started","order.reserved","order.confirmed","order.expired","order.voided","order.refunded"],"type":"string"},"lines":{"type":"array","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":2048},"saleKeyId":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"sceneId":{"type":"string","minLength":1,"maxLength":64},"url":{"type":"string","maxLength":2048},"utm":{"type":"object","properties":{"utm_campaign":{"type":"string","maxLength":512},"utm_content":{"type":"string","maxLength":512},"utm_id":{"type":"string","maxLength":512},"utm_medium":{"type":"string","maxLength":512},"utm_source":{"type":"string","maxLength":512},"utm_term":{"type":"string","maxLength":512}}},"visitId":{"type":"string","format":"uuid"}},"required":["eventId","eventName"]}}}},"responses":{"202":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"accepted":{"const":true},"visitId":{"type":"string","format":"uuid"}},"required":["accepted","visitId"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/analytics/track/server":{"post":{"operationId":"analytics.trackServerEvent","summary":"Track server analytics event","description":"Accept a server-emitted attribution event, including order-linked conversions. Requires a server-side API key.","tags":["analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cartId":{"type":"string","format":"uuid"},"cartRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"eventContractId":{"type":"string","minLength":1,"maxLength":64},"eventId":{"type":"string","format":"uuid"},"eventName":{"enum":["visit.started","event.viewed","tier.viewed","cart.updated","cart.url_created","checkout.started","order.reserved","order.confirmed","order.expired","order.voided","order.refunded"],"type":"string"},"lines":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"quantity":{"type":"integer","minimum":1,"maximum":9007199254740991},"saleKeyId":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"amountUsdc":{"type":"string","pattern":"^-?\\d+$"},"refundId":{"type":"string","format":"uuid"}},"required":["quantity","saleKeyId"]}},"referrer":{"type":"string","maxLength":2048},"saleKeyId":{"type":"string","pattern":"^0x[0-9a-fA-F]+$"},"sceneId":{"type":"string","minLength":1,"maxLength":64},"url":{"type":"string","maxLength":2048},"utm":{"type":"object","properties":{"utm_campaign":{"type":"string","maxLength":512},"utm_content":{"type":"string","maxLength":512},"utm_id":{"type":"string","maxLength":512},"utm_medium":{"type":"string","maxLength":512},"utm_source":{"type":"string","maxLength":512},"utm_term":{"type":"string","maxLength":512}}},"visitId":{"type":"string","format":"uuid"},"orderId":{"type":"string","minLength":1}},"required":["eventId","eventName"]}}}},"responses":{"202":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"accepted":{"const":true},"visitId":{"type":"string","format":"uuid"}},"required":["accepted","visitId"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/availability":{"patch":{"operationId":"management.updateEventAvailability","summary":"Update event availability","description":"Update managed event capacity, visibility, or registration availability.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"capacity":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"exclusiveMinimum":0},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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/{tierId}":{"patch":{"operationId":"management.updateEventTier","summary":"Update an event tier","description":"Update managed ticket tier metadata, pricing, capacity, sale windows, or validity.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"tierId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"x-partner-operator-id","in":"header","schema":{"type":"string","minLength":1,"maxLength":256}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}]},"description":{"type":"string","maxLength":2000},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"label":{"type":"string","minLength":1,"maxLength":256},"priceUsdc":{"type":"string","pattern":"^\\d+$"},"promoCode":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"sortOrder":{"type":"integer","minimum":0,"maximum":9007199254740991},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"totalQuantity":{"type":"string","pattern":"^[1-9]\\d*$"},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"object","properties":{"acceptingRegistration":{"type":"boolean"},"additionalDetails":{"anyOf":[{"type":"string"},{"type":"null"}]},"allowTicketTransfers":{"type":"boolean"},"archivedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"capacity":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time"},"customQuestions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"required":{"type":"boolean"},"type":{"enum":["text","address/ens","date"],"type":"string"}},"required":["id","label","required","type"]}},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"emailSettings":{"anyOf":[{"type":"object","properties":{"avatarUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"hostName":{"anyOf":[{"type":"string","minLength":1,"maxLength":256},{"type":"null"}]},"supportEmail":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}]}},"required":["avatarUrl","hostName","supportEmail"]},{"type":"null"}],"default":null},"endAt":{"type":"string","format":"date-time"},"eventType":{"enum":["RSVP","TICKETED"],"type":"string"},"hideAddressUntilConfirmed":{"type":"boolean"},"id":{"type":"string","minLength":1},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isCheckInOpen":{"type":"boolean"},"isNonProfit":{"type":"boolean"},"location":{"anyOf":[{"anyOf":[{"type":"object","properties":{"address":{"type":"string","minLength":1},"kind":{"const":"physical"},"name":{"type":"string","minLength":1}},"required":["kind"]},{"type":"object","properties":{"kind":{"const":"virtual"},"name":{"type":"string","minLength":1},"url":{"type":"string","minLength":1}},"required":["kind"]}]},{"type":"null"}]},"referralFeeBps":{"type":"integer","minimum":0,"maximum":9700,"default":0},"requireApproval":{"type":"boolean"},"sceneId":{"type":"string","minLength":1},"slug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"startAt":{"type":"string","format":"date-time"},"state":{"enum":["draft","publishing","published","archived"],"type":"string"},"taxEnabled":{"type":"boolean"},"taxRateBps":{"anyOf":[{"type":"integer","minimum":0,"maximum":10000},{"type":"null"}],"default":null},"ticketOrderLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticketTotalLimit":{"type":"integer","minimum":0,"maximum":9007199254740991},"timezone":{"type":"string"},"title":{"type":"string","minLength":1},"updatedAt":{"type":"string","format":"date-time"},"vendorFeesEnabled":{"type":"boolean"},"videoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"visibility":{"enum":["public","private"],"type":"string"}},"required":["acceptingRegistration","additionalDetails","allowTicketTransfers","archivedAt","capacity","createdAt","customQuestions","description","endAt","eventType","hideAddressUntilConfirmed","id","imageUrl","isCheckInOpen","isNonProfit","location","requireApproval","sceneId","slug","startAt","state","taxEnabled","ticketOrderLimit","ticketTotalLimit","timezone","title","updatedAt","vendorFeesEnabled","videoUrl","visibility"]},"operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"enum":["pending","running","completed","failed","reconciliation_required"],"type":"string"}},"required":["id","status"]},"tiers":{"type":"array","items":{"type":"object","properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"endAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"eventId":{"type":"string","minLength":1},"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"priceUsdc":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"promoCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"remainingQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"requiredParentTicketTierId":{"anyOf":[{"type":"string"},{"type":"null"}]},"soldQuantity":{"type":"string","pattern":"^\\d+$"},"sortOrder":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"startAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"ticketGroup":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"string","pattern":"^\\d+$"},"totalQuantity":{"anyOf":[{"type":"string","pattern":"^\\d+$"},{"type":"null"}]},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["color","description","endAt","eventId","id","label","priceUsdc","promoCode","remainingQuantity","requiredParentTicketTierId","soldQuantity","sortOrder","startAt","ticketGroup","tokenId","totalQuantity","validFrom","validUntil"]}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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-codes/validate":{"post":{"operationId":"storefront.validateCartCodes","summary":"Validate cart codes","description":"Validate access and discount codes against a point-in-time cart and return pricing without reserving inventory or creating a checkout token.","tags":["storefront"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accessCode":{"type":"string","minLength":1,"maxLength":500},"discountCode":{"type":"string","minLength":1,"maxLength":500},"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"]}}},"required":["eventId","items"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"accessCode":{"type":"object","properties":{"status":{"enum":["applied","invalid","expired","inactive","not_applicable","not_supplied"],"type":"string"}},"required":["status"]},"discountCode":{"type":"object","properties":{"savings":{"anyOf":[{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},{"type":"null"}]},"status":{"enum":["applied","invalid","expired","inactive","not_applicable","not_supplied"],"type":"string"}},"required":["savings","status"]},"pricing":{"anyOf":[{"type":"object","properties":{"discount":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"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"]},"referrerFee":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"total":{"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","referrerFee","total","vendorFee"]},"subtotal":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"taxes":{"type":"object","properties":{"salesTax":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]},"total":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]}},"required":["salesTax","total"]},"total":{"type":"object","properties":{"amountUSD":{"type":"number"},"amountUSDC":{"type":"string","pattern":"^\\d+$"},"formatted":{"type":"string"}},"required":["amountUSD","amountUSDC","formatted"]}},"required":["discount","fees","subtotal","taxes","total"]},{"type":"null"}]},"valid":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}},"required":["accessCode","discountCode","pricing","valid","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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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}/check-ins/validate":{"post":{"operationId":"management.validateEventCheckIn","summary":"Validate an event check-in token","description":"Validate an event-bound ticket QR token and return its current holder and ticket state.","tags":["management"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1,"maxLength":128}},"required":["token"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"attendee":{"type":"object","properties":{"firstName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}]},"tickets":{"type":"array","items":{"type":"object","properties":{"checkedIn":{"type":"boolean"},"label":{"anyOf":[{"type":"string"},{"type":"null"}]},"quantity":{"type":"string","pattern":"^\\d+$"},"tokenId":{"type":"string","pattern":"^\\d+$"},"valid":{"type":"boolean"},"validFrom":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"validUntil":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["checkedIn","label","quantity","tokenId","valid","validFrom","validUntil"]}},"walletAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["firstName","lastName","tickets","walletAddress"]}},"required":["attendee"]}}}},"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"}}}},"429":{"description":"429","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"}}}},"503":{"description":"503","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"}}}}}}}}}