Skip to content

Advanced Data

This page describes the API methods that help you pull information about the completed orders.

Note

This functionality is exclusively accessible with paid subscriptions. Verify whether your plan includes this feature, upgrade if necessary, or reach out to us for assistance.

Note

Before calling any of the methods on this page, you must obtain a valid authorization token. To learn about obtaining an authorization token, please read the Authentication section.

List event tickets

Returns a list of all the orders that have been completed.

HTTP request

POST https://l.oveit.com/api/crm/orders

Request parameters

Parameter Description
token A valid access token, obtained in the Authentication step.
include Specify the fields you wish to export, allowing for multiple fields separated by commas. Below, you can find a list of all possible inclusions. see Includes.
p Page number.

Includes

Parameter Description
invoices include invoices for every order
tickets include tickets issued for every order
customer_form include customer form for every order
registration_form include registration form for every ticket issued
event include event details for every ticket issued
ticket_type include ticket type details for every ticket issued
addons include addons for every ticket issued
wallet_credit include wallet credit for every ticket issued
customer include customer info for every order
items include order items info for every order

Response example

{
  "data": [
    {
      "id": 1,
      "uuid": "830583df-002d-4004-b98f-d28d18b04629",
      "date": "2024-01-30T15:06:02+02:00",
      "date_formatted": "Jan 30, 2024, at 15:06",
      "language": "en",
      "currency": "EUR",
      "payment_processor": null,
      "status": "Completed",
      "is_canceled": false,
      "pending_reason": null,
      "email": "developer@oveit.com",
      "items": [
        {
          "name": "Event with Registration Form (Free)",
          "quantity": "1",
          "currency": "EUR",
          "type": "ticket",
          "price_without_tax": "0.00",
          "price_tax": "0.00",
          "fee_without_tax": "0.00",
          "fee_tax": "0.00",
          "discount": "0.00",
          "final_price": "0.00",
          "event": {
            "name": "Event with Registration Form",
            "hash": "e3aefd2bf9",
            "location": "Studio4",
            "has_venue": false,
            "starts_at": null,
            "ends_at": null,
            "is_perpetual": true
          },
          "ticket_type": {
            "name": "Free",
            "has_nft": false,
            "is_seatless": false
          }
        },
        {
          "name": "Event with Registration Form (VIP Ticket)",
          "quantity": "1",
          "currency": "EUR",
          "type": "ticket",
          "price_without_tax": "1.69",
          "price_tax": "0.32",
          "fee_without_tax": "0.17",
          "fee_tax": "0.03",
          "discount": "0.00",
          "final_price": "2.22",
          "event": {
            "name": "Event with Registration Form",
            "hash": "e3aefd2bf9",
            "location": "Studio4",
            "has_venue": false,
            "starts_at": null,
            "ends_at": null,
            "is_perpetual": true
          },
          "ticket_type": {
            "name": "VIP Ticket",
            "has_nft": false,
            "is_seatless": false
          }
        }
      ],
      "customer": {
        "name": "Oveit Developer",
        "is_company": false,
        "tax_code": null,
        "address": "115 Wild Basin Rd. S Ste 307",
        "city": "Austin",
        "state": "Texas",
        "state_code": "TX",
        "country": "United States",
        "country_code": "US"
      },
      "customer_form": [
        {
          "name": "Type",
          "value": "Online"
        }
      ],
      "tickets": [
        {
          "code": "fca326c2",
          "event": {
            "name": "Event with Registration Form",
            "hash": "e3aefd2bf9",
            "location": "Studio4",
            "has_venue": false,
            "starts_at": null,
            "ends_at": null,
            "is_perpetual": true
          },
          "ticket_type": {
            "name": "VIP Ticket",
            "has_nft": false,
            "is_seatless": false
          },
          "series": "DDD 18",
          "seat": null,
          "registration_form": [
            {
              "name": "Name",
              "value": "Oveit Attendee"
            },
            {
              "name": "Position",
              "value": "Developer"
            }
          ],
          "wallet_credit": {
            "amount": 0,
            "currency": "EUR"
          },
          "addons": [
            {
              "name": "Beer",
              "uses": 2
            }
          ]
        },
        {
          "code": "4ffc47ce",
          "event": {
            "name": "Event with Registration Form",
            "hash": "e3aefd2bf9",
            "location": "Studio4",
            "has_venue": false,
            "starts_at": null,
            "ends_at": null,
            "is_perpetual": true
          },
          "ticket_type": {
            "name": "Free",
            "has_nft": false,
            "is_seatless": false
          },
          "series": "EFD 2",
          "seat": null,
          "registration_form": [
            {
              "name": "Name",
              "value": "Oveit Attendee2"
            },
            {
              "name": "Position",
              "value": "Developer"
            }
          ],
          "wallet_credit": {
            "amount": 0,
            "currency": "EUR"
          },
          "addons": null
        }
      ],
      "invoice": [
        {
          "name": "Invoice - Oveit Developer - Nr. OVEIT 007",
          "number": "OVEIT 7",
          "items": [
            {
              "name": "Event with Registration Form (VIP Ticket)",
              "quantity": 1,
              "currency": "EUR",
              "unit_net_price": "1.69",
              "unit_tax_price": "0.32",
              "total_price": "2.02"
            },
            {
              "name": "Event with Registration Form (Free)",
              "quantity": 1,
              "currency": "EUR",
              "unit_net_price": "0.00",
              "unit_tax_price": "0.00",
              "total_price": "0.00"
            },
            {
              "name": "Online processing fee",
              "quantity": 1,
              "currency": "EUR",
              "unit_net_price": "0.17",
              "unit_tax_price": "0.03",
              "total_price": "0.20"
            }
          ],
          "statements": [
            "VAT exempt, according to Directive 2006/112/EC"
          ],
          "download_link": "https://l.test.oveit.com/orders/download_invoice",
          "currency": "EUR",
          "net_price": "1.86",
          "tax_price": "0.35",
          "total_price": "2.22",
          "is_canceled": false,
          "is_paid": true,
          "is_reversed": false,
          "is_reverse": false,
          "status": "paid"
        }
      ]
    }
  ],
  "next_page": 2,
  "prev_page": null,
  "total_items": 123,
  "total_pages": 7
}

Notes:

  • The next_page field is set to null when there is no next page available.
  • The prev_page field is set to null when there is no previous page available.
  • Each request can retrieve a maximum of 20 items in the order list. Please utilize the p parameter to navigate through the entire list.
  • The date attribute is a date formatted using the complete ISO 8601 format.