Create a new booking

This is the basic workflow how to create a new booking over the api.

1. Create a customer

If you don’t have an existing customer you want to use, create a new one.

POST https://api.ticketpark.ch/persons/

{
    "salutation": "m",
    "firstname": "Tom",
    "lastname": "Tomson",
    "email": "tom@tomsons.com",
    "address": {
        "country": "CH",
        "address1": "Testweg 10",
        "address2": "",
        "zip": "3000",
        "city": "Bern"
    }
}

Hint

In the response look for the Location header field to get the newly created pid.

2. Create a booking

Create a booking and add the customer to it.

POST https://api.ticketpark.ch/bookings/

{
    "customer": "{pid of person from request 1}"
}

Hint

Due to validation constraints You can’t create a delivery booking just yet. If you need delivery booking, see hint in point 4.

3. Reserve some tickets

Add some tickets to the booking. Note how in this example we create two tickets with just one request.

A tickets is defined by

• a price
• a show
• a sector or a seat

In this example we assume you already have your event set up and you know the pids of your prices, shows and sectors.

POST https://api.ticketpark.ch/tickets/

[
{
    "booking": "{pid of booking from request 2}",
    "show": "{pid of a show}",
    "price": "{pid of a price}",
    "sector": "{pid of a sector}"
},
{
    "booking": "{pid of booking from request 2}",
    "show": "{pid of a show}",
    "price": "{pid of a price}",
    "sector": "{pid of a sector}"
}
]

4. Confirm booking

Every booking needs to be confirmed. Tickets of unconfirmed bookings will be released again after 30 minutes.

PATCH https://api.ticketpark.ch/bookings/{pid of booking from request 2}

{
    "confirmation": true
}

Hint

If you want the booking to be delivered by postal mail, you can set the dispatch method now. With the tickets already reserved, the system will find the correct DeliveryRates and add Deliveries to the Booking

{
    "confirmation": true,
    "delivery": true
}

5. Send confirmation email

Optionally, you can send the confirmation mail for the booking you just created.

POST https://api.ticketpark.ch/email/send

{
    "booking": "{pid of booking from request 2}",
    "type": "confirmation"
}