List of Ticket-Orders

GET https://api.e-guma.ch/v1/ticketing/orders.json?apikey={api-key}

Parameters

ParameterDescription
api-key required
updated_at_afterShow orders modified at or after date (format: 2019-06-04T23:15:14).
updated_at_beforeShow orders modified before date (format: 2019-07-04T23:15:14).
order_numberThe sequential number of the order, e.g., 1000001.
last_nameThe last name of the person associated with the order. It is case-sensitive.

Return

ParameterDescription
idThe ID of the order.
created_atThe autogenerated date and time (ISO 8601 format) when the order was created. E.g. 2019-06-03T19:16:43.
updated_atThe date and time (ISO 8601 format) when the order was last modified. When an order is created then updated_at has the same value as created_at.
order_numberThe order number.
statuscompleted or cancelled.
currencyThe three-letter code (ISO 4217 format) for the currency. Each shop only supports one currency.
languageLanguage as a two-letter code (ISO 639-1).
locationweb or local.
noteThis field combines the internal and external notes.
tagsList of tags. If there are no tags, an empty array is returned.
discount_in_centsThe total discounts applied to the price of the order.
grand_total_in_centsThe sum of all line item prices, shipping fee, and added discounts.
promocodeThe used promocode. If no promocode is used, null is returned.
promocode_nameThe internal name of the used promocode. If no promocode is used, null is returned.
customerCustomer, see customer object below for details. The customer object can be null.
order_linesList of order lines, see order line object below for details.
paymentsList of payments, see payment object below for details.

Customer object

ParameterDescription
idThe ID of the customer.
titleMr, Mrs or Company.
first_nameFirst name.
last_nameLast name.
companyCompany name.
streetStreet.
zipZip code.
cityCity.
countryCountry as two-letter code (ISO 3166-1 alpha-2).
emailEmail address.
accepts_marketingWhether the customer consented (Double Opt-in) to receive email newsletters.
double_opt_in_confirmed_atIf the customer consented to receive the email newsletter, then the date and time (ISO 8601 format) of the Double Opt-in will be returned. Otherwise, this value will be null.
phonePhone number.

Order line object

product_idThe ID of the product.
nameThe name of the event or admission (e.g. Magical Brunch).
starts_atDate and time (ISO 8601 format) when the event occurs. This value is null for admission-tickets without a start date.
ticket_type_idThe id of the ticket type
ticket_type_nameThe name of the ticket type (e.g. Normal price)
quantityQuantity
total_price_in_centsquantity x unit_price_in_cents
tagsList of tags. If there are no tags, an empty array is returned.
total_count_peopleCount of people for this ticket type. This value corresponds to this setting.
ticketsList of tickets.

Ticket object

numberThe ticket number.
count_peopleCount of people per ticket. Default value is 1 (ticket for one person).
answersList of answers to ticket questions. Answers can be null. If there are no questions, an empty array is returned.

Payment object

payment_idThe ID of the payment method.
nameThe name of the payment method. E.g. Credit Card
amount_in_centsAmount
is_complimentaryIndicates if a payment is complimentary.

Example

GET https://api.e-guma.ch/v1/ticketing/orders.json?updated_at_after=2025-01-21T10:00:00&apikey=6731db84973b860a08f4023c
[
  {
    "id": "678f6cde973b8604d43af956",
    "created_at": "2025-01-21T10:46:05",
    "updated_at": "2025-01-21T10:46:05",
    "order_number": "1000572",
    "status": "completed",
    "currency": "CHF",
    "language": "en",
    "location": "web",
    "discount_in_cents": 0,
    "grand_total_in_cents": 5000,
    "promocode": "12345",
    "promocode_name": "Sample promocode",
    "customer": {
      "id": "0f580e21-67dd-43d8-b097-72fd75a1acba",
      "title": "Mr",
      "first_name": "Christoph",
      "last_name": "Lehner",
      "company": "Idea Creation GmbH",
      "street": "Walchestrasse 15",
      "zip": "8006",
      "city": "Zürich",
      "country": "CH",
      "email": "ch.lehner@e-guma.ch",
      "accepts_marketing": false,
      "double_opt_in_confirmed_at": null,
      "phone": "044 500 54 00"
    },
    "order_lines": [
      {
        "product_id": "678f5130973b950bb88d3f7a",
        "name": "Magical Brunch",
        "starts_at": "2027-01-21T20:00:00",
        "ticket_type_id": "caeadb8f-2b6d-424c-ad8a-4caf42505691",
        "ticket_type_name": "Normalpreis",
        "unit_price_in_cents": 5000,
        "quantity": 1,
        "total_price_in_cents": 5000,
        "total_count_people": 1,
        "tags": [],
        "tickets": [
          {
            "number": "5679006056898985032",
            "count_people": 1,
            "answers": [
              {
                "name": "First name",
                "type": "text",
                "value": "John"
              },
              {
                "name": "Last name",
                "type": "text",
                "value": "Doe"
              },
              {
                "name": "Birthday",
                "type": "dateTime",
                "value": "1990-12-31"
              },
              {
                "name": "Company",
                "type": "text",
                "value": "e-guma"
              },
              {
                "name": "Open question",
                "type": "text",
                "value": "Sample text"
              },
              {
                "name": "Select",
                "type": "optionId",
                "value": null
              }
            ]
          }
        ]
      },
      {
        "product_id": "678f5130973b950bb88d3f7a",
        "name": "Magical Brunch",
        "starts_at": "2027-01-21T20:00:00",
        "ticket_type_id": "d05b4d7a-4ca7-41c4-b203-35d6106c1c8a",
        "ticket_type_name": "Gratisticket",
        "unit_price_in_cents": 0,
        "quantity": 1,
        "total_price_in_cents": 0,
        "total_count_people": 1,
        "tags": [],
        "tickets": [
          {
            "number": "5177348347062652981",
            "count_people": 1,
            "answers": [
              {
                "name": "First name",
                "type": "text",
                "value": ""
              },
              {
                "name": "Last name",
                "type": "text",
                "value": ""
              },
              {
                "name": "Birthday",
                "type": "dateTime",
                "value": null
              },
              {
                "name": "Company",
                "type": "text",
                "value": ""
              },
              {
                "name": "Open question",
                "type": "text",
                "value": ""
              },
              {
                "name": "Select",
                "type": "optionId",
                "value": null
              }
            ]
          }
        ]
      }
    ],
    "payments": [
      {
        "payment_id": "63206fa6973b861ff8e05230",
        "name": "VISA",
        "amount_in_cents": 5000,
        "is_complimentary": false
      }
    ],
    "tags": [
      "tag-1"
    ],
    "note": ""
  }
]