POST

Create Reservation

Reserves tickets for 20 minutes. Reserved tickets are deducted from tickets stock and cannot be bought by another party. When the reservation expires, the tickets are added back in the stock.

Permissions
Manage Events - all permissions
Manage Orders
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/events/v1/checkout/reservations
Body Params
eventIdstringRequiredformat GUID

Event ID.

ticketQuantitiesArray <TicketReservationQuantity>minItems 1maxItems 50

Tickets to reserve.

ignoreLimitsboolean

Whether to ignore the available ticket limits upon reservation.

allowHiddenTicketsboolean

Whether to allow reservation for hidden tickets.

Response Object
idstringformat GUID

Reservation ID.

expiresstringformat date-time

Reservation expiration timestamp.

reservationsArray <TicketReservation>

Ticket reservations.

invoiceInvoice

Reservation invoice.

reservationStatusstring

Reservation status.

Create Reservation Example 1
Request
cURL
curl -X POST 'https://www.wixapis.com/events/v1/events/fd56076c-38f4-4705-b9eb-ec322b85c745/tickets/reservation' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH TOKEN>' \
--data-binary '{
                 "ticketQuantities": [
                   {
                     "ticketDefinitionId": "48da25d2-afb2-4955-92a0-b820635ac321",
                     "quantity": 1
                   },
                   {
                     "ticketDefinitionId": "9c13fb37-f2c6-4c9c-8950-41c49b0a5c84",
                     "quantity": 2
                   }
                 ]
               }'
Response
JSON
{
  "id": "1fe76e20-efa0-4330-be44-2a8b2ca3c208",
  "expires": "2020-05-22T13:12:54.804Z",
  "reservations": [
    {
      "quantity": 1,
      "ticket": {
        "id": "48da25d2-afb2-4955-92a0-b820635ac321",
        "price": {
          "amount": "0.00",
          "currency": "EUR"
        },
        "free": true,
        "name": "Nice ticket",
        "description": "",
        "limitPerCheckout": 0,
        "orderIndex": 0
      }
    },
    {
      "quantity": 2,
      "ticket": {
        "id": "9c13fb37-f2c6-4c9c-8950-41c49b0a5c84",
        "price": {
          "amount": "100.00",
          "currency": "EUR"
        },
        "free": false,
        "name": "VIP ticket",
        "description": "",
        "limitPerCheckout": 0,
        "orderIndex": 0
      }
    }
  ],
  "invoice": {
    "items": [
      {
        "id": "48da25d2-afb2-4955-92a0-b820635ac321",
        "quantity": 1,
        "name": "Nice ticket",
        "price": {
          "amount": "0.00",
          "currency": "EUR"
        },
        "total": {
          "amount": "0.00",
          "currency": "EUR"
        },
        "fees": []
      },
      {
        "id": "9c13fb37-f2c6-4c9c-8950-41c49b0a5c84",
        "quantity": 2,
        "name": "VIP ticket",
        "price": {
          "amount": "100.00",
          "currency": "EUR"
        },
        "total": {
          "amount": 200.0,
          "currency": "EUR"
        },
        "fees": []
      }
    ],
    "total": {
      "amount": "200.00",
      "currency": "EUR"
    },
    "subTotal": {
      "amount": "200.00",
      "currency": "EUR"
    },
    "grandTotal": {
      "amount": "200.00",
      "currency": "EUR"
    },
    "fees": [],
    "revenue": {
      "amount": "200.00",
      "currency": "EUR"
    }
  }
}
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?