> For the complete documentation index, see [llms.txt](https://docs.entrytickets.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.entrytickets.eu/dashboard/tickets/types.md).

# Types

## Retrieving ticket and voucher types

The ticket types API allows you to retrieve detailed information about available ticket and voucher types for an event, including pricing, options, and descriptions.

{% hint style="info" %}
Pricing is multicurrency. Amounts use currency-keyed `prices` and `fees` objects&#x20;

(for example `{ "EUR": 75 }`). Even with a single currency, the shape stays an object, never a bare number.
{% endhint %}

### Request

**`GET`** `/tickets/types`

**Params**

<table><thead><tr><th width="122.4765625">Name</th><th>Mandatory</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>event</td><td>Required</td><td>string</td><td>Event slug identifier</td></tr></tbody></table>

**Request Example**

```
curl --request GET \
  --url 'https://entrytickets.be/api/tickets/types?event=summer-festival-2025'
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "ticket_types": {
    "weekend_pass_early": {
      "name": "Weekend Pass - Early Bird",
      "prices": {
        "EUR": 75,
        "USD": 82
      },
      "fees": {
        "EUR": 2.5,
        "USD": 2.75
      },
      "dates": ["2025-08-16", "2025-08-17"],
      "description": "Full Weekend Access",
      "options": {
        "tier": {
          "type": "select",
          "required": true,
          "options": {
            "standard": {
              "prices": { "EUR": 0, "USD": 0 },
              "fees": { "EUR": 0, "USD": 0 },
              "description": "Standard Access"
            },
            "vip": {
              "prices": { "EUR": 45, "USD": 49 },
              "fees": { "EUR": 1.5, "USD": 1.65 },
              "description": "VIP Experience with backstage access"
            }
          }
        }
      }
    },
    "saturday_only": {
      "name": "Saturday Day Pass",
      "prices": {
        "EUR": 42
      },
      "fees": {
        "EUR": 1.8
      },
      "dates": ["2025-08-16"],
      "description": "Saturday Only Access",
      "options": {}
    }
  },
  "voucher_types": {
    "parking_main_saturday": {
      "name": "Main Parking",
      "prices": {
        "EUR": 15,
        "USD": 16.5
      },
      "fees": {
        "EUR": 0.8,
        "USD": 0.9
      },
      "dates": ["2025-08-16"],
      "description": "Main Parking Saturday",
      "category": "parking_main"
    },
    "food_voucher_20": {
      "name": "Food Credit",
      "prices": {
        "EUR": 20
      },
      "fees": {
        "EUR": 0.5
      },
      "dates": ["2025-08-16", "2025-08-17"],
      "description": "€20 Food & Beverage Credit",
      "category": "food_credit"
    }
  }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}

**Ticket Type Fields**

<table><thead><tr><th width="154.33203125">Field</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>Display name of the ticket type</td></tr><tr><td>prices</td><td>Base price per currency code (e.g. <code>{ "EUR": 75 }</code>)</td></tr><tr><td>fees</td><td>Service fee per currency code (e.g. <code>{ "EUR": 2.5 }</code>)</td></tr><tr><td>dates</td><td>Array of event dates this ticket is valid for (<code>YYYY-MM-DD</code>)</td></tr><tr><td>description</td><td>Description of the ticket type</td></tr><tr><td>options</td><td>Object containing available ticket options/upgrades</td></tr></tbody></table>

**Ticket Option Fields**

<table><thead><tr><th width="145.4375">Field</th><th>Description</th></tr></thead><tbody><tr><td>type</td><td>Type of option (e.g., "select", "checkbox")</td></tr><tr><td>required</td><td>Whether this option is required for purchase</td></tr><tr><td>options</td><td>Object containing available choices for this option</td></tr></tbody></table>

**Option Choice Fields**

<table><thead><tr><th width="133.34375">Field</th><th width="160.44140625">Type</th><th>Description</th></tr></thead><tbody><tr><td>prices</td><td>object</td><td>Base price per currency code</td></tr><tr><td>fees</td><td>object</td><td>Service fee per currency code</td></tr><tr><td>description</td><td>string</td><td>Description of the option choice</td></tr></tbody></table>

**Voucher Type Fields**

<table><thead><tr><th width="151.17578125">Field</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>Display name of the voucher type</td></tr><tr><td>prices</td><td>Base price per currency code</td></tr><tr><td>fees</td><td>Service fee per currency code</td></tr><tr><td>dates</td><td>Array of event dates this voucher is valid for (<code>YYYY-MM-DD</code>)</td></tr><tr><td>description</td><td>Description of the voucher</td></tr><tr><td>category</td><td>Category/group this voucher belongs to</td></tr></tbody></table>
