---
title: "GET /api/customers/me/transactions"
method: GET
path: "/api/customers/me/transactions"
tags: ["api", "customers"]
---

# GET /api/customers/me/transactions

`GET /api/customers/me/transactions`

Get transactions of customer

## Query parameters

- `locale` string
- `subscriptionId` string
- `checkoutId` string

## Response `200`

OK

- GETCustomersGetTransactionsOfCustomer200Response
  - `transactions` object[]
    - `tid` string, required — The ID of the transaction
    - `secret` string, required — The secret token of the transaction
    - `subscriptionId` string — The ID of the subscription of the transaction
    - `tickets` object[] — An array of cart ticket items of the transaction
      - `type` 'ticket' — The type of the cart item.
      - `_id` string — Unique identifier for the cart item. If omitted, the system will automatically generate one.
      - `name` string, nullable — The name of the cart item.
      - `amount` integer, required — The amount of the cart item.
      - `netPrice` number, float — The single piece net price of the cart item.
      - `price` number, float, required — The single piece price of the cart item.
      - `taxRate` number, float, nullable — The tax rate to be applied to this cart item. If not present the tax rate of the transaction is taken.
      - `triggeredBy` union — An ID or an array of IDs of other cart items which triggered the buy action of the cart item.
        - string — An ID of another cart item which triggered the buy action of the cart item.
        - string[] — An array of IDs of other cart items which triggered the buy action of the cart item.
      - `bundleInfo` object, nullable
        - `bundleId` string
        - `componentId` string
        - `optionId` string
      - `ticketTypeId` string, required — The ID of the ticket type of the cart item.
      - `categoryRef` string — The category reference of the ticket type.
      - `seatingInfo` object, nullable — The associated seating object.
        - `_id` string — The ID of the seating object.
        - `_type` 6 | 7, float, required — Indicates the type of seating object. Seat = 6, General Admission = 7.
        - `categoryId` string — The ID of the category containing the seating object.
        - `statusId` string, required — The ID of a container holding information about the seating status of the seating object.
        - `name` string, nullable — If _type == 7. The name of the general admission.
        - `seatType` 'handicapped' | 'limitedView' | 'foldable', nullable — If _type == 6. The type of the seat. null = normal.
        - `sectionName` string, nullable — If _type == 6. The name of the section where the seat is located.
        - `groupName` string, nullable — If _type == 6. The name of the row group where the seat is located.
        - `rowName` string, nullable — If _type == 6. The name of the row where the seat is located.
        - `seatName` string, nullable — If _type == 6. The seat name.
        - `gate` string, nullable — The entry gate associated with the seating object.
      - `slotInfo` object, nullable — The associated time slot object.
        - `slotId` string, required — The ID of the time slot.
        - `slotStartTime` string, required — The start time of the time slot.
      - `asHardTicket` boolean, nullable — Whether this ticket is a hard ticket.
      - `listingId` string, nullable — Listing in secondary market.
      - `listingItemId` string, nullable — The ID of the listing item in the secondary market.
      - `triggeredAutomations` boolean, nullable — Whether the cart item triggered automations.
      - `meta` object, nullable — Meta data which is propagated to the ticket.
      - `addOns` object[] — A list of Add-Ons of the ticket.
        - `productId` string, required
        - `productVariantId` string, required
        - `name` string, required
      - `capabilities` union[], nullable — The capabilities of the ticket.
        - union
          - object
            - `type` 'self_service_return', required
            - `settings` object, required
              - …
          - object
            - `type` 'repersonalization', required
            - `settings` object, required
              - …
      - `taxInfo` object — The tax info details.
        - `serviceTypeId` string — The ID of the service type.
        - `exceptionId` string — The ID of the exception.
        - `proceedsAccountId` string — The ID of the proceeds account.
        - `proceedsAccountCode` string — The code of the proceeds account.
        - `taxItems` object[] — The array of tax items.
          - `name` string, nullable
          - `taxTypeId` string, nullable
          - `rate` number, float, required
          - `perUnit` number, float, required
          - `total` number, float, required
          - `netTotal` number, float, nullable
          - `netPerUnit` number, float, nullable
          - `taxPayableAccountId` string, nullable
          - `taxPayableAccountCode` string, nullable
    - `products` object[] — An array of cart product items of the transaction
      - `type` 'product', required — The type of the cart item.
      - `_id` string — Unique identifier for the cart item. If omitted, the system will automatically generate one.
      - `name` string, nullable — The name of the cart item.
      - `amount` integer, required — The amount of the cart item.
      - `netPrice` number, float — The single piece net price of the cart item.
      - `price` number, float, required — The single piece price of the cart item.
      - `taxRate` number, float, nullable — The tax rate to be applied to this cart item. If not present the tax rate of the transaction is taken.
      - `triggeredBy` union — An ID or an array of IDs of other cart items which triggered the buy action of the cart item.
        - string — An ID of another cart item which triggered the buy action of the cart item.
        - string[] — An array of IDs of other cart items which triggered the buy action of the cart item.
      - `bundleInfo` object, nullable
        - `bundleId` string
        - `componentId` string
        - `optionId` string
      - `productVariantId` string, required — The ID of the product variant.
      - `isFulfillable` boolean — Whether the product can be delivered
      - `taxInfo` object — The tax info details.
        - `serviceTypeId` string — The ID of the service type.
        - `exceptionId` string — The ID of the exception.
        - `proceedsAccountId` string — The ID of the proceeds account.
        - `proceedsAccountCode` string — The code of the proceeds account.
        - `taxItems` object[] — The array of tax items.
          - `name` string, nullable
          - `taxTypeId` string, nullable
          - `rate` number, float, required
          - `perUnit` number, float, required
          - `total` number, float, required
          - `netTotal` number, float, nullable
          - `netPerUnit` number, float, nullable
          - `taxPayableAccountId` string, nullable
          - `taxPayableAccountCode` string, nullable
    - `realPrice` number, float, required — The calculated real price of the transaction
    - `currency` 'EUR' | 'USD' | 'GBP' | 'AUD' | 'CHF' | 'THB' | 'ILS' | 'COP' | 'MXN' | 'DKK' | 'NOK' | 'SEK' | 'QAR' | 'CAD' | 'ISK' | 'GTQ' | 'INR' | 'DOP' | 'SGD' | 'PLN' | 'SAR' | 'TTD' | 'ZAR' | 'KYD' | 'HKD' | 'CZK' | 'KRW' | 'JPY' | 'NZD' | 'AED' | 'MAD' | 'TWD' | 'BRL' | 'BWP' | 'NAD' | 'KES' | 'SCR' | 'TRY' | 'SZL' | 'LSL' | 'TZS' | 'UGX' | 'ZMW' | 'ZWG' | 'GHS' | 'NGN' | 'SLE' | 'LRD' | 'XOF' | 'XAF' | 'GEL' | 'IDR' | 'ARS' | 'CRC' | 'HUF' | 'EGP' | 'MYR' | 'VND' | 'PHP' | 'MWK' — An ISO 4217 3-character code of the currency
    - `vouchers` string[] — An array of voucher codes applied to this transaction
    - `redeemedVouchers` object — An array of voucher codes redeemed for this transaction
      - `totalRedeemedAmount` number, float, required — The sum of all vouchers applied.
      - `vouchers` object[] — An array of all redeemed vouchers.
        - `_id` string — The ID of the voucher.
        - `code` string, required — The Code of the voucher.
        - `redeemedAmount` number, float, required — The applied value of the voucher.
    - `email` string, email — The email of the user of the transaction
    - `status` 'NEW' | 'RESERVED-BY-SYSTEM' | 'ABORTED' | 'COMPLETE' | 'CANCELED', required — The status of the transaction.
    - `company` string — The company name of the user of the transaction
    - `name` string — The name of the user of the transaction
    - `prename` string — The firstname of the user of the transaction
    - `lastname` string — The lastname of the user of the transaction
    - `street` string — The street of the user of the transaction
    - `line2` string — The additional address field of the user of the transaction.
    - `postal` string — The postal of the user of the transaction
    - `city` string — The city of the user of the transaction
    - `state` string — The state of the user of the transaction
    - `country` string — The country of the user of the transaction
    - `createdAt` string, date-time — An ISO timestamp indicating when the transaction was created
    - `eventId` string, required — The ID of the event containing this transaction
    - `paymentStatus` 'AWAITING' | 'PENDING' | 'RECEIVED' | 'REFUND' | 'CANCELED' | 'FAILED' | 'DISPUTE' | 'CHARGEBACK' | 'POS-RECEIVED' | 'POS-CANCELED' | 'LOCAL-PENDING' | 'LOCAL-AWAITING' | 'LOCAL-RECEIVED' | 'EXTERNAL' — The payment status of the transaction.
    - `outerCharge` number, float — The outer charge of the transaction
    - `paymentMethod` 'paypal' | 'stripe' | 'local' | 'external' | 'vivenu-payments' — The payment method of the transaction.
    - `preferredLanguage` 'de' | 'de-CH' | 'en' | 'en-GB' | 'en-AU' | 'fr' | 'es' | 'es-MX' | 'is' | 'it' | 'ru' | 'pt' | 'tr' | 'nb' | 'nl' | 'pl' | 'sv' | 'sl' | 'da' | 'cs' | 'lv' | 'he' | 'ar' | 'th' | 'ko' | 'ja' | 'zh-TW' — The preferred language of the transaction. It is determined automatically
    - `extraFields` object — The extra fields of the transaction
    - `underShop` string — The under shop of the transaction
    - `paymentInfoMethod` string — The method of the payment
    - `coupons` string[] — An array of coupon codes applied
  - `events` PublicEventResource[]
    - `_id` string, required — The ID of the event
    - `sellerId` string — The ID of the seller owning this event
    - `meta` object — Custom key-value data. Metadata is useful for storing additional, structured information on an object.
    - `eventType` 'SINGLE' | 'GROUP' | 'RECURRENCE' | 'ROOT' — The type of the event. SINGLE = it is a single event. GROUP = the event is part of a group of events
    - `name` string, required — The name of the event
    - `start` string, date-time, required — An ISO timestamp indicating when the event starts
    - `end` string, date-time, required — An ISO timestamp indicating when the event ends
    - `url` string — The url of the event
    - `slogan` string — The slogan of the event
    - `description` string — A description about the event. Description is in RichText - JSON format.
    - `image` string — An image for the event
    - `pageStyle` string — The page style of the event page
    - `styleOptions` object — Style options of the event page
      - `headerStyle` string — Header style of the event page
      - `brandOne` string — First brand of the event
      - `brandTwo` string — Second brand of the event
      - `hideLocationMap` boolean — Whether the location map on the event page hide
      - `hideLocationAddress` boolean — Whether the location address on the event page hide
      - `categoryAlignment` number, float — The style of category alignment. 0 = cascade = categories among themselves. 1 = asTabs = categories as tabs. 2 = boxes = categories as boxes. 3 = ticket wizard = categories as ticket wizard if configured.
      - `showAvailabilityIndicator` boolean — Whether the availability indicator on the event page should be shown
      - `availabilityIndicatorThresholds` number[] — The availability indicator thresholds of the event
      - `showAvailable` boolean — Whether to show availability of the time slot. Only applicable for time slot events.
      - `timeSlotsCheckoutSelection` 'beforeTickets' | 'afterTickets' — Time slots selection in checkout.
    - `video` object — The video settings of the event
      - `youtubeID` string — The youtube video ID of the event video setting
    - `gallery` object[] — An array of gallery items of the event
      - `_id` string, required — The ID of the gallery item
      - `title` string — The title of the gallery item
      - `description` string — The description of the gallery item
      - `copyright` string — The copyright of the gallery item
      - `index` number, float — The index of the gallery item
      - `image` string — The image of the gallery item
    - `checkinInformation` object — The checkin information of the event
      - `_id` string, required — The ID of the checkin information of the event
      - `checkinStarts` string, date-time — The date of when the checkin of the event starts
    - `accentColor` string — The accent color of the event page
    - `tickets` object[] — An array of ticket types of the event
      - `_id` string, required — The ID of the ticket type of the event
      - `name` string, required — The name of the ticket type of the event
      - `description` string — The description of the ticket type of the event
      - `image` string — The image of the ticket type of the event
      - `color` string — The font color of the ticket type of the event
      - `price` number, float, required — The price of the ticket type of the event
      - `amount` number, float, required — The amount of the ticket type of the event
      - `active` boolean, required — Whether the ticket type of the event is active
      - `posActive` boolean — Whether POS for the ticket type of the event is active
      - `categoryRef` string — The reference of the category of the ticket type of the event
      - `ignoredForStartingPrice` boolean — Whether the price of the ticket type should be ignored on starting price determination of the event
      - `conditionalAvailability` boolean — Whether rules can be operated on the ticket type
      - `ticketBackground` string — The background for the ticket PDF of the ticket type
      - `rules` object[] — An array of rules for the ticket type of the event
        - `_id` string, required — The ID of the ticket type rule
        - `ticketGroup` string, required — The ID of the ticket group to operate the rule on
        - `min` number, float, required — Minimum amount of tickets where the rule is active
        - `max` number, float, required — Maximum amount of tickets where the rule is active
      - `requiresPersonalization` boolean — Deprecated, use `requiresPersonalizationMode` instead
      - `requiresPersonalizationMode` 'ENABLED' | 'DISABLED', nullable — Whether the ticket type of the event needs personalization
      - `requiresExtraFields` boolean — Deprecated, use `requiresExtraFieldsMode` instead
      - `requiresExtraFieldsMode` 'ENABLED' | 'DISABLED', nullable — Whether the ticket type of the event needs extra fields
      - `repersonalizationAllowedMode` 'ENABLED' | 'DISABLED', nullable — Whether re-personalization (name changes) is allowed for this ticket type. When unset, inherits the event-level `repersonalizationAllowed`. Enables flex-ticket-like re-personalization without an addon.
      - `repersonalizationFee` number, float, nullable — The per-ticket fee for repersonalization.
      - `sortingKey` number, float — The key to sort the ticket type within the ticket group
      - `enableHardTicketOption` boolean — Whether the ticket type is a hard ticket
      - `forceHardTicketOption` boolean — Whether to force the hard ticket option
      - `maxAmountPerOrder` number, float — Maximum amount per order of the ticket type
      - `minAmountPerOrder` number, float — Minimum amount per order of the ticket type
      - `minAmountPerOrderRule` number, float — Minimum amount of the ticket type, where the minAmountPerOrder goes active
      - `taxRate` number, float — The tax rate of the ticket type of the event
      - `styleOptions` object — Style options of the ticket type
        - `thumbnailImage` string — Thumbnail of the ticket type, which will be displayed on checkout
        - `showAvailable` boolean — Whether to show availability of the ticket type
        - `hiddenInSelectionArea` boolean — Whether to show this ticket in the selection area
      - `priceCategoryId` string — The ID of the price category of the ticket type
      - `entryPermissions` string[] — An array of IDs of entry permissions where the ticket buyer has access to certain areas
      - `ignoreForMaxAmounts` boolean — Do not include tickets if this typw when calculating available amount in categories and event
      - `expirationSettings` object — Expiration settings of the ticket type.
        - `enabled` boolean — Whether expiration enabled for the event ticket types
        - `expiresAfter` object — If enabled = true. A relatve date specification until when ticket is valid.
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
      - `barcodePrefix` string — Characters that precede the barcodes of tickets.
      - `salesStart` object, nullable — A relative date before the end of the event, when the sale of this ticket type starts
        - `target` string, nullable — The target of the relative date
        - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
        - `offset` integer, required — The offset to the date
      - `salesEnd` object, nullable — A relative date before the end of the event, when the sale of this ticket type ends
        - `target` string, nullable — The target of the relative date
        - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
        - `offset` integer, required — The offset to the date
      - `transferSettings` object — Transfer settings of the ticket type.
        - `mode` 'ALLOWED' | 'DISABLED' — Ticket transfer mode.
        - `expiresAfter` object — If 'mode = ALLOWED'. A relatve date specification until when ticket transfer is valid.
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
        - `retransferMode` 'ALLOWED' | 'DISABLED' — Ticket retransfer mode.
        - `allowedUntil` object — If 'mode = ALLOWED'. A relatve date specification until the end of the event where ticket transfer is possible.
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
        - `hardTicketsMode` 'ALLOWED' | 'DISABLED' — If 'hardTicketsMode = ALLOWED' then hard tickets transfers allowed.
        - `seasonTicketMode` 'NO_RESTRICTION' | 'CHILDREN_ONLY' | 'GROUP_ONLY' — Restrict how season tickets can be transferred.
      - `scanSettings` object — Scan settings of the ticket type.
        - `feedback` 'highlight' — Feedback mode during scanning of the ticket
        - `allowedScanCount` number, float — Number of times a ticket is allowed to be scanned as valid
      - `deliverySettings` object — Delivery settings of the ticket type.
        - `wallet` object
          - `enabled` 'ENABLED' | 'DISABLED', nullable
        - `pdf` object
          - `enabled` 'ENABLED' | 'DISABLED', nullable
      - `meta` object — Custom key-value data. Metadata is useful for storing additional, structured information on an object.
      - `revealingSettings` object — Barcode reveal settings of the ticket type.
        - `enabled` 'ENABLED' | 'DISABLED', nullable
        - `beforeEvent` object
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
    - `ticketExtraFields` object[] — An array of extra fields for ticket types of the event
      - `_id` string, required — The ID of the extra field
      - `name` string — The name of the extra field
      - `description` string — The description of the extra field
      - `required` boolean, required — Whether the extra field is required
      - `collectInCheckout` boolean — Whether the extra field is collected in checkout
      - `deleted` boolean — Whether the extra field is deleted
      - `type` 'text' | 'number' | 'select' | 'checkbox' | 'tel' | 'country' | 'email' | 'date' | 'documentUpload' | 'signature' | 'address' — The type of the extra field. text = is a text field. number = is a number field. select = is a selection field of different selections. checkbox = is a checkbox field. tel = is a number field for a phone number. email = is a text field for an email. country = is a text field field for country.
      - `options` string[] — An array of options of the extra field
      - `onlyForCertainTicketTypes` boolean — Whether the extra field is only for certain ticket types
      - `allowedTicketTypes` string[] — An array of IDs of the ticket types allowed for the extra field
      - `printable` boolean — Whether the extra field is printable
      - `conditions` object[] — An array of conditions of the extra field. The conditions can refer to other extra fields.
        - `_id` string, required — The ID of the condition
        - `baseSlug` string, required — The slug of the base extra field which the condition refers to
        - `value` union — The value which the operator will be used on to check the condition.
          - boolean
          - number
          - object
          - string
        - `operator` 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'greaterThanOrEquals' | 'lessThanOrEquals' | 'exists' | 'notExists', required — The operator which will be used to check the condition
      - `settings` union — Type-specific settings for the extra field
        - object
          - `allowedMimeTypes` string[]
        - object
          - `variant` 'date' | 'birthdate', required
          - `minimumAge` number, float, nullable
          - `maximumAge` number, float, nullable
        - object
          - `document` object
            - `url` string, uri, required
            - `fileName` string, required
            - `mimeType` 'application/pdf', required
          - `documentName` string
          - `requireScrollthrough` boolean
    - `ticketDesign` object — The ticket design settings for ticket types of the event
      - `_id` string, required — The ID of the ticket types design of the event
      - `useCustomDesign` boolean — Whether to use custom design on ticket types of event
      - `customDesignURL` string — The custom design URL for ticket types of event
      - `footerDesignURL` string — The footer design URL for ticket types of the event
      - `disclaimer` string — The disclaimer for ticket types of the event
      - `infoColor` string — The info color for ticket types of the event
      - `showTimeRange` boolean — Whether to show time range on ticket types of the event
      - `hideDates` boolean — Whether to hide dates on ticket types of the event
      - `hideTimes` boolean — Whether to hide the time on ticket types of the event
    - `extraFields` object[] — An array of extra fields of the event
      - `_id` string, required — The ID of the extra field
      - `name` string — The name of the extra field
      - `description` string — The description of the extra field
      - `required` boolean, required — Whether the extra field is required
      - `collectInCheckout` boolean — Whether the extra field is collected in checkout
      - `deleted` boolean — Whether the extra field is deleted
      - `type` 'text' | 'number' | 'select' | 'checkbox' | 'tel' | 'country' | 'email' | 'date' | 'documentUpload' | 'signature' | 'address' — The type of the extra field. text = is a text field. number = is a number field. select = is a selection field of different selections. checkbox = is a checkbox field. tel = is a number field for a phone number. email = is a text field for an email. country = is a text field field for country.
      - `options` string[] — An array of options of the extra field
      - `onlyForCertainTicketTypes` boolean — Whether the extra field is only for certain ticket types
      - `allowedTicketTypes` string[] — An array of IDs of the ticket types allowed for the extra field
      - `printable` boolean — Whether the extra field is printable
      - `conditions` object[] — An array of conditions of the extra field. The conditions can refer to other extra fields.
        - `_id` string, required — The ID of the condition
        - `baseSlug` string, required — The slug of the base extra field which the condition refers to
        - `value` union — The value which the operator will be used on to check the condition.
          - boolean
          - number
          - object
          - string
        - `operator` 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'greaterThanOrEquals' | 'lessThanOrEquals' | 'exists' | 'notExists', required — The operator which will be used to check the condition
      - `settings` union — Type-specific settings for the extra field
        - object
          - `allowedMimeTypes` string[]
        - object
          - `variant` 'date' | 'birthdate', required
          - `minimumAge` number, float, nullable
          - `maximumAge` number, float, nullable
        - object
          - `document` object
            - `url` string, uri, required
            - `fileName` string, required
            - `mimeType` 'application/pdf', required
          - `documentName` string
          - `requireScrollthrough` boolean
    - `showCountdown` boolean — Whether the countdown should be visible till event start
    - `showOtherEvents` boolean — Whether other events should be displayed on the event page
    - `hardTicketSettings` object — The hard ticket settings of the event
      - `_id` string, required — The ID of the event hard ticket settings
      - `enabled` boolean — Whether hard tickets can be bought for this event
      - `fulfillmentType` 'self' | 'managed' — The type of fulfillment. self fulfilled by the seller. managed fulfilled by vivenu.
      - `printingMethod` 'preprinted' | 'adhoc' — Which printing method is used. preprinted = The tickets are preprinted. adhoc = The tickets are printed ad-hoc.
      - `hardTicketOuterCharge` number, float — Additional charge for every hard ticket that is added to the ticket price and the other outer charges - paid by the ticket buyer.
      - `hardTicketInnerCharge` number, float — Additional charge for hard tickets as in the contract of the seller
      - `hardTicketPreviewURL` string — The hard ticket design image
      - `promotionName` string — A special name for hard tickets. e.g. "Collector edition"
      - `promotionText` string — A description about what makes this ticket so special
      - `requiredDays` integer — Required days until deliver of the hard tickets
    - `tracking` object — The tracking of the event
      - `facebookPixel` object — The facebook pixel information of the event tracking
        - `active` boolean — Whether facebook pixel of event tracking is active
        - `pixelId` string — The ID of facebook pixel of the event tracking
      - `tagging` object — The tagging of the event tracking
        - `enabled` boolean — Whether tagging of event tracking is enabled
        - `tags` string[] — An array of tags of the event tracking
    - `seoSettings` object — The search engine optimization settings of the event
      - `_id` string, required — The ID of the SEO setting
      - `tags` string[] — An array of tags of the seo settings
      - `noIndex` boolean — Whether the seo setting has no indexing
      - `title` string — The title of the seo settings
      - `description` string — The description of the seo settings
    - `soldOutFallback` object — The sold out fallback of the event
      - `_id` string, required — The ID of sold out entry
      - `soldOutFallbackType` 'default' | 'moreinformation' | 'waitinglist'
      - `soldOutFallbackLink` string — The link of the sold out fallback
    - `reservationSettings` object — The reservation settings of event
      - `_id` string, required — The ID of the reservation setting
      - `option` 'noReservations' | 'reservationsOnly' | 'reservationsAndPayment' | 'internalReservationsAndPayment' — The option of the reservation setting. reservationsOnly = needs reservation only. noReservations = no reservations needed. reservationsAndPayment = needs reservation and payment
      - `strategyId` string — The ID of the strategy of a purchase intents to be used on the event
    - `customTextConfig` object — The custom text configuration of the event
      - `_id` string, required — The ID of the custom text configuration
      - `buyTicketsCTA` string — The custom CTA after buy tickets
    - `timezone` string — Timezone of event
    - `ticketSettings` object — The event ticket settings
      - `codeDisplay` 'BARCODE' | 'QRCODE' | 'HIDE', nullable — How the ticket code is displayed. Null inherits the seller setting.
      - `cancellationStrategy` 'disabled' | 'freeTicketsOnly' | 'withoutRefund' — Cancellation strategy of the ticket types
      - `revealingSettings` object — Barcode reveal settings of the event.
        - `enabled` 'ENABLED' | 'DISABLED', nullable
        - `beforeEvent` object
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
      - `transferSettings` object — Transfer settings of the ticket types
        - `mode` 'ALLOWED' | 'DISABLED' — Ticket transfer mode.
        - `expiresAfter` object — If 'mode = ALLOWED'. A relatve date specification until when ticket transfer is valid.
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
        - `retransferMode` 'ALLOWED' | 'DISABLED' — Ticket retransfer mode.
        - `allowedUntil` object — If 'mode = ALLOWED'. A relatve date specification until the end of the event where ticket transfer is possible.
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
        - `hardTicketsMode` 'ALLOWED' | 'DISABLED' — If 'hardTicketsMode = ALLOWED' then hard tickets transfers allowed.
        - `seasonTicketMode` 'NO_RESTRICTION' | 'CHILDREN_ONLY' | 'GROUP_ONLY' — Restrict how season tickets can be transferred.
        - `useSeasonCardTemplate` boolean — Whether to use the season card template for individual tickets transferred from the season.
      - `upgradeSettings` object — Upgrade settings of the ticket types
        - `enabled` 'ENABLED' | 'DISABLED' — Whether ticket upgrade settings enabled.
        - `underShopMapping` object[] — Mapping to define the under shop in which a ticket upgrade will be performed.
          - `type` 'tag', required
          - `tag` string, required — The customer tag
          - `underShopId` string, required — The ID of the under shop.
      - `resellSettings` object — Resell settings
        - `enabled` 'ENABLED' | 'DISABLED', nullable — Whether resell is enabled
        - `resellerFeeFix` number, float, nullable — The fixed fee per ticket that the reseller pays
        - `resellerFeeVar` number, float, nullable — The variable fee per ticket that the reseller pays
        - `buyerFeeFix` number, float, nullable — The fixed fee per ticket that the buyer pays
        - `buyerFeeVar` number, float, nullable — The variable fee per ticket that the buyer pays
        - `offerCreationStart` object, nullable — A relative date specification of offers creation start.
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
        - `offerCreationEnd` object, nullable — A relative date specification of offers creation end.
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
        - `salesStart` object, nullable — A relative date specification of sales start.
          - `target` string, nullable — The target of the relative date
          - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
          - `offset` integer, required — The offset to the date
        - `priceMarkup` number, float, nullable — The markup applied to the price of each ticket bought on the secondary market.
        - `cartAutomationMode` 'BLOCKED' | 'INDIVIDUAL', nullable — Controls whether tickets involved in cart automations can be resold.
      - `barcodeSettings` object — Barcode settings
        - `issueOfflineBarcodes` 'ENABLED' | 'DISABLED' — Whether offline barcodes are enabled
      - `childEventMapping` object[] — Child event mapping
        - `childEventId` string, required — The child event for this mapping
        - `ticketTypeMapping` object, required — Mapping between ticket types of the parent event and the child events
        - `valueShare` number, float, nullable — The percentage value of this child event from the value of the parent event
      - `seasonCardValueStrategy` 'childValue' | 'averagePerChild' | 'sharePerChild' — The strategy used to determine the value of a child event in the context of the parent event
    - `rootId` string — The id of the root event
    - `customSettings` object — Custom settings of the event
      - `_id` string, required — The ID of the custom settings of the event
      - `hideTicketsInTransactionPage` boolean — Whether the ticket types of the event should be visible on transaction page
      - `dontSendTicketMail` boolean — Whether an email should be sent of tickets of the event
      - `dontSendBookingConfirmationMail` boolean — Whether an email should be sent for booking confirmation
      - `customMailHeaderImage` string — A custom header image of the mail for ticket types of the event
      - `customTransactionCompletionText` string — A custom transaction completion text for completed transactions of the event
      - `disableAppleWallet` boolean — Whether the Apple and Google Wallet functionality should be disabled on the event. Deprecated: use event.deliverySettings.wallet instead
      - `disablePdfTickets` boolean — Whether the PDF tickets download functionality should be disabled on the event. Deprecated: use event.deliverySettings.pdf instead
      - `showStartDate` boolean — Whether the start date of the event should be visible on listings
      - `showStartTime` boolean — Whether the start time of the event should be visible on listings
      - `showEndDate` boolean — Whether the end date of the event should be visible on listings
      - `showEndTime` boolean — Whether the end time of the event should be visible on listings
      - `showTimeRangeInListing` boolean — Whether the end time of the event should be visible on listings
      - `showTimeRangeInTicket` boolean — Whether the time range of the event should be visible on ticket PDFs
      - `customCheckoutCSS` string — Custom CSS styling of the checkout of the event
      - `useCustomCheckoutBrand` boolean — Whether the checkout of the event should use custom brand
      - `customCheckoutBrand` string — A custom checkout brand of the event
      - `hideLogoInCheckout` boolean — Whether the logo should be hide on the checkout of the event
      - `customEventPageHTML` string — A custom HTML of the event page
      - `customEventPageCSS` string — A custom css styling of the event page
      - `customConfirmationPage` string — A custom css styling of the event page
      - `hideSeatmapInCheckout` boolean — Hides the seatmap from the ticket buyer even if seating ticket types are available
      - `dontSendBookingConfirmationSMS` boolean — Whether a sms should be sent for booking confirmation
    - `upsellSettings` object — The upsell settings of the event
      - `_id` string, required — The ID of the upsell settings of the event
      - `active` boolean — Whether upselling is active on the event
      - `productStream` string — The product stream for upselling
      - `headerImage` string — A header image for the ticket shop, when selecting products
      - `crossSells` object — The cross selling settings.
        - `eventIds` string[] — The array of the promoted event IDs.
    - `category` string — The category of the extra information of the event
    - `subCategory` string — The subCategory of the extra information of the event
    - `showTimeRangeInTicket` boolean — Whether the time range of the event should be visible on ticket PDFs
    - `showTimeRangeInListing` boolean — Whether the end time of the event should be visible on listings
    - `showStartDate` boolean — Whether the start date of the event should be visible on listings
    - `showStartTime` boolean — Whether the start time of the event should be visible on listings
    - `showEndDate` boolean — Whether the end date of the event should be visible on listings
    - `showEndTime` boolean — Whether the end time of the event should be visible on listings
    - `accountSettings` object
      - `_id` string, required — The ID of the account settings of the event
      - `enforceAccounts` boolean — Whether to enforce accounts for the event
      - `enforceAuthentication` 'DISABLED' | 'PREVENT_CHECKOUT' | 'PREVENT_DETAILS_STEP' — Whether to enforce authentication for the event and how to enforce it
    - `location` object
      - `locationName` string — The name of the location where the event takes place
      - `locationStreet` string — The street of the location where the event takes place
      - `locationCity` string — The city of the location where the event takes place
      - `locationPostal` string — The postal code of the location where the event takes place
      - `locationCountry` string — The country code of the location where the event takes place
      - `geoCode` object — The geographic code of the event
        - `_id` string, required — The ID of the geo code
        - `lat` number, float, required — Latitude coordinate of the geo code
        - `lng` number, float, required — Longitude coordinate of the geo code
    - `resell` object — Resell information
      - `saleActive` boolean — Whether the event has buying on the secondary market active.
      - `offerActive` boolean — Whether the event has selling on the secondary market active.
      - `fees` object — Fee information
        - `buyerFeeFix` number, float — The fixed fees charged for each ticket to the buyer.
        - `buyerFeeVar` number, float — The variable fees charged to the buyer.
      - `priceMarkup` number, float — The markup applied to the price of each ticket bought on the secondary market.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/vivenu/apis/vivenu-api.md) · [All operations](https://skmtc.net/vivenu/apis/vivenu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivenu/vivenu-api/revisions/36be0dca14e7/schema)
