> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Ticket Definitions V3

# Type: Ticket Definition Object

# Link: https://dev.wix.com/docs/api-reference/business-solutions/events/event-management/ticket-definitions-v3/ticket-definition-object.md

## Description: A Ticket Definition is a reusable configuration for an event that specifies ticket settings such as pricing, service fee handling, availability limits, and sale period.

You can use Ticket Definitions to define and manage ticket types, control inventory and sale windows, and automate updates via the API.

Read more about [Ticket Definitions](https://support.wix.com/en/article/creating-tickets-for-your-event).

## Schema:

```json
 Type: Ticket Definition Object | type: TicketDefinition
 Description: A Ticket Definition is a reusable configuration for an event that specifies ticket settings such as pricing, service fee handling, availability limits, and sale period.

You can use Ticket Definitions to define and manage ticket types, control inventory and sale windows, and automate updates via the API.

Read more about [Ticket Definitions](https://support.wix.com/en/article/creating-tickets-for-your-event).
       - name: id  | type: string | description: Ticket definition ID.
           - name: value  | type: string | description: 
       - name: eventId  | type: string | description: Event ID to which the ticket definition belongs.
       - name: revision  | type: string | description: Revision number, which increments by 1 each time the ticket definition is updated. To prevent conflicting changes, the existing `revision` must be used when updating a ticket definition.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the ticket definition was created.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the ticket definition was updated.
       - name: name  | type: string | description: Ticket definition name.
       - name: description  | type: string | description: Ticket definition description.
       - name: policyText  | type: string | description: Ticket definition policy.
       - name: hidden  | type: boolean | description: Whether this ticket definition is hidden from site visitors and can't be purchased.
       - name: limited  | type: boolean | description: Whether the ticket has a limited maximum quantity.
       - name: initialLimit  | type: number | description: The maximum number of tickets that can be sold for the event when first defining the event. If a seating map is defined after you created a ticket definition, this property is ignored and `actualLimit` is used instead. To create unlimited tickets, skip this field in the request.
           - name: value  | type: number | description: 
       - name: actualLimit  | type: number | description: The maximum number of tickets that can be sold for the event after adding a seating map to the event. If no seating map is defined, this property is the same as `initialLimit`.
       - name: pricingMethod  | type: PricingMethod | description: Ticket pricing method.
           - name: pricingType  | type: string | description: Ticket price type.
               enum: STANDARD, DONATION
           - name: free  | type: boolean | description: Whether the ticket is free. To create a free ticket, enter `"0"` in `pricingMethod.fixedPrice.value`.
       - name: feeType  | type: string | description: Type of ticket service fee to collect.
           enum: FEE_INCLUDED, FEE_ADDED_AT_CHECKOUT, NO_FEE
       - name: salePeriod  | type: SalePeriod | description: Ticket sale period.
           - name: startDate  | type: string | description: Date and time the ticket sale starts. Rounded down to the nearest minute.
           - name: endDate  | type: string | description: Date and time the ticket sale ends. Rounded down to the nearest minute.
           - name: displayNotOnSale  | type: boolean | description: Whether to display the ticket if it's not available to buy.
       - name: saleStatus  | type: string | description: Ticket sale status.
           enum: SALE_SCHEDULED, SALE_STARTED, SALE_ENDED
       - name: salesDetails  | type: SalesDetails | description: Ticket sales information. <br> <br> **Note:** This field is only returned when `SALES_DETAILS` is specified in `field` in the request.
           - name: unsoldCount  | type: number | description: Number of tickets that haven't been purchased yet. The field is `null` if the ticket quantity is unlimited.
           - name: soldCount  | type: number | description: Number of purchased tickets.
           - name: reservedCount  | type: number | description: Number of reserved tickets.
           - name: soldOut  | type: boolean | description: Whether the tickets are sold out.
               - name: value  | type: boolean | description: 
       - name: limitPerCheckout  | type: number | description: Number of tickets that can be purchased per checkout. <br> <br> **Note:** If the `actualLimit` or `salesDetails.unsoldCount` field value is smaller than `limitPerCheckout`, then it overrides this field.
       - name: extendedFields  | type: ExtendedFields | description: Data extensions.
           - name: namespaces  | type: object | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured.  You can only access fields for which you have the appropriate permissions.  Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields.md).
       - name: eventDetails  | type: EventDetails | description: Information about the even the ticket is for. <br> **Note:** This field is only returned when `EVENT_DETAILS` is specified in `field` in the request.
           - name: title  | type: string | description: Event title.
           - name: shortDescription  | type: string | description: Short description of the event.
           - name: location  | type: Location | description: Event location.
               - name: name  | type: string | description: Location name. This value is displayed instead of the address when the location is defined as TBD by setting the `locationTbd` property to `true`.
               - name: type  | type: string | description: Location type.
               - name: address  | type: Address | description: Exact location address.
               - name: locationTbd  | type: boolean | description: Whether the event location is TBD.
           - name: dateAndTimeSettings  | type: DateAndTimeSettings | description: Event date and time settings.
               - name: dateAndTimeTbd  | type: boolean | description: Whether the event date and time are TBD.
               - name: dateAndTimeTbdMessage  | type: string | description: Message that is displayed when time and date is TBD.  **Note:** This field is only used when the `dateAndTimeTbd` field value is `true`.
               - name: startDate  | type: string | description: Event start date.  **Note:** This field is only returned when the `dateAndTimeTbd` field value is `false`.
               - name: endDate  | type: string | description: Event end date.  **Note:** This field is only returned when the `dateAndTimeTbd` field value is `false`.
               - name: timeZoneId  | type: string | description: Event time zone ID in the [TZ database](https://www.iana.org/time-zones) format.  **Note:** This field is only returned when the `dateAndTimeTbd` field value is `false`.
               - name: hideEndDate  | type: boolean | description: Whether the end date is hidden in the formatted date and time.
               - name: showTimeZone  | type: boolean | description: Whether the time zone is displayed in the formatted schedule.
               - name: recurrenceStatus  | type: string | description: Repeating event status.
               - name: recurringEvents  | type: Recurrences | description: Event repetitions.
               - name: formatted  | type: Formatted | description: Formatted date and time settings.
           - name: eventPageUrl  | type: PageUrl | description: Event page URL components.
               - name: base  | type: string | description: The base URL. For premium sites, the base is the domain. For free sites, the base is the Wix site URL (for example, `https://mysite.wixsite.com/mysite`).
               - name: path  | type: string | description: The path to the page. For example, `/product-page/a-product`.
           - name: status  | type: string | description: Event status.
               enum: UPCOMING, STARTED, ENDED, CANCELED, DRAFT
       - name: seatingDetails  | type: SeatingDetails | description: Seating information including available seats and areas for this ticket definition. <br> **Note:** This field is only returned when `SEATING_DETAILS` is specified in `field` in the request, and when the event has a [seating plan](https://support.wix.com/en/article/wix-events-creating-a-seating-map).
           - name: places  | type: Array<AvailablePlace> | description: List of available places.
               - name: placeId  | type: string | description: Place ID in the format `{sectionId}-{elementId}-{label}`. For example, `0-1-A5`.
               - name: label  | type: string | description: Human-readable label for this place, such as `A1`, `12`, or `VIP1`.
               - name: sectionLabel  | type: string | description: High-level division of the venue, where the place is located, such as `Orchestra`, `Balcony`, or `VIP Section`.
               - name: elementLabel  | type: string | description: Seating element within the section, such as `Row`, `Table`, or `General Admission`.
               - name: availableCapacity  | type: number | description: Available capacity at this place.  For general seating type returns the number of remaining spots.  For other types returns `1`. For example, if a table has 5 chairs, each chair is treated as a separate place, which has a capacity of 1.

```