# Introduction

With the Ticket Definitions API, you can create definitions for tickets. A definition includes the following ticket settings:

- Fee type. Determine whether the fee will be paid by a guest or a seller.
- Pricing. Define different ticket prices based on factors such as early bird discounts, VIP packages, group rates, or special promotions. Several pricing methods are available for you to select from: **Fixed price**, **Guest price**, **Free**. Additionally, you can customize prices for different groups of people using **Price options**.
- Availability. Set the ticket limit available to buy. Also, you are able to check number of purchased or reserved tickets.
- Sale period. Set the sale start and end dates. Also, when defining the sale period, it is possible to choose to display event tickets to customers even before the sale starts.

## Terminology

- **Pricing method**: Different pricing methods are available for an event:
    - **Fixed price**: All tickets in the same definition are sold at the exact same price, regardless of when they are purchased or other factors.
    - **Guest price**: The guest enters the ticket price. Optionally, you can set the minimum price guests must pay for a ticket. This pricing method is applied to donation.
    - **Price options**: All tickets in the same ticket definition are priced at different rates, such as different prices for adults, children, and students.
- **Ticket availability**: The status of ticket inventory, indicating whether tickets are available or sold out. This type can also include availability limits and timeframes for ticket sales.
- **Sale period**: Duration of time during which event tickets are available for purchase.
- **Event Dashboard**: Control center in the Wix site UI for managing site event settings and features.

@package_metadata:@wix/events

To use the TicketDefinitionsV2 API, install the `@wix/events` package.

#### Install the package

Follow the installation instructions for your development environment.

| Development environment | Installation method |
|--|--|
| Wix sites (editor or IDE) | Use the [package manager](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-in-the-editor). |
| Wix sites (local IDE) | Run `wix install @wix/events` using the [Wix CLI](fallback::https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/packages/work-with-npm-packages-with-the-wix-cli).|
| Blocks apps | Use the same installation method as Wix sites. |
| CLI and self-hosted apps | Run `npm install @wix/events` or `yarn add @wix/events`. |
| Headless sites and apps | Run `npm install @wix/events` or `yarn add @wix/events`. |

#### Import the package

To import the package in your code:

```js
import { ticketDefinitionsV2 } from '@wix/events'
```

Coding Examples

Sled Tests

Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

API Reference

Velo

Picasso

GraphQL (Alpha)

onTicketDefinitionSaleStarted( )