{
  1. Introduction
  2. Version Control
  3. Ticket Shop Api
    1. Authentication
    2. Event
      1. Calculation Of Fees
    3. Discount Codes
    4. Calendar
      1. Time Slots Year Month
      2. Time Slots Year Month Day
    5. Reservation
      1. Create Reservation
      2. Update Reservation
    6. Checkout

Create Reservation

Create a new reservation for a specific event.

POST https://api.cmtelecom.com/ticketingapi/v1.0/ticketshop/events/{event_uuid}/reservations?key=KEY123&code=DISCOUNT123

POST Parameters

Type Name Description Required Example
Header X-CM-PRODUCTTOKEN The product token. True 00000000-0000-0000-0000-000000000000
Header Content-Type The content type which the application expects. True application/json
Path Variable event_uuid The UUID of an event can be retrieved from the Ticketing Dashboard. True 00000000-0000-0000-0000-000000000000
Query Parameter key In some cases, an organiser wants to lock the ticket store. This can be done with our access key option. The end user has a key to unlock the ticket store. In the case the access keys are activated, the key needs to be send to our API. False KEY123
Query Parameter code In the case the discount codes are activated and used, the discount code needs to be send to our API. This can be done with a query parameter “code” in the URL. False DISCOUNT123
Body Reservation Object The reservation to create (JSON object.) True Reservation Object

Request: Reservation Object

{
    "time_slot_id" : null,
    "customer_data": {
        "uuid": null,
        "first_name": "John",
        "last_name": "Doe",
        "email": "johndoe@example.com",
        "mobile": "+31612345678",
        "gender": "M",
        "address_line_1": null,
        "address_line_2": null,
        "zipcode": null,
        "city": null,
        "state": null,
        "organisation_name": null,
        "position_name": null,
        "date_of_birth": null,
        "custom_field_1": null,
        "custom_field_2": null,
        "custom_field_3": null,
        "created_at": null,
        "updated_at": null,
        "country_id": "NL"
    },
    "ticket_types": [
        {
            "uuid": "00000000-0000-0000-0000-000000000000",
            "amount": 1
        },
        {
            "uuid": "00000000-0000-0000-0000-000000000000",
            "amount": 5
        }
    ]
}

Response

Http status Description Example
201 Successful operation Reservation Object
400 Bad request Info Message

Response: Reservation Object

{
    "order_id": "CMTICKETS123XX",
    "due_at": "2018-12-24T13:34:07+00:00",
    "customer_data": {
          "uuid": "00000000-0000-0000-0000-000000000000",
          "first_name": "John",
          "last_name": "Doe",
          "email": "johndoe@example.com",
          "mobile": "+31612345678",
          "gender": "M",
          "address_line_1": null,
          "address_line_2": null,
          "zipcode": null,
          "city": null,
          "state": null,
          "organisation_name": null,
          "position_name": null,
          "date_of_birth": null,
          "custom_field_1": null,
          "custom_field_2": null,
          "custom_field_3": null,
          "created_at": null,
          "updated_at": null,
          "country_id": "NL"
    },
    "ticket_types": [
        {
            "uuid": "00000000-0000-0000-0000-000000000000",
            "amount": 1
        },
        {
            "uuid": "00000000-0000-0000-0000-000000000000",
            "amount": 5
        }
    ]
}