Tonic Availability

Get Events

get

https://api-qa.tonicticketing.com/v1https://api-demo.tonicticketing.com/v1https://api.tonicticketing.com/v1

/availability/occurrences

Endpoint to view occurrences for a selected date range.

One of event brand, organisation, event or venue is required.

Query parameters

event_brandstringRequired

Event Brand ID

Example: 68c2a1aba911520a75279f14Pattern: ^[a-f\d]{24}$

organisation_idstringOptional

Organisation ID

Example: 62da553c6a1b8e00c9571b7dPattern: ^[a-f\d]{24}$

eventstringOptional

Event ID

Example: 60929ba841366425510568a1Pattern: ^[a-f\d]{24}$

venuestringOptional

Venue ID

Example: 6308a1ede4076400101e2397Pattern: ^[a-f\d]{24}$

start_datestring · dateRequired

Start date for the range of occurrences to find . This has to be within 31 days of the end_date

Example: 2030-01-01Pattern: ^\d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])$

end_datestring · dateRequired

End date for the range of occurrences to find. This has to be within 31 days of the start_date

Example: 2030-02-01Pattern: ^\d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])$

Header parameters

authorizationstringRequired

Contains bearer followed by bearer token

Example: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjgxZjNhZTUyZDVmYzJkNzEwM2VmMDNjN2UwOThiOTA4NmE1NDE0M2M0M2Y0ODBmMThjYmI4NTI0ODI0Y2U5MmY0YWFjZjhiN2Q5ZDZlNWU2In0.eyJhdWQiOiI1OWU3MjljNTJmOGU5ZDYyZTg3ZmMwNTIiLCJqdGkiOiI4MWYzYWU1MmQ1ZmMyZDcxMDNlZjAzYzdlMDk4YjkwODZhNTQxNDNjNDNmNDgwZjE4Y2JiODUyNDgyNGNlOTJmNGFhY2Y4YjdkOWQ2ZTVlNiIsImlhdCI6MTc1Nzk0OTAyOCwibmJmIjoxNzU3OTQ5MDI4LCJleHAiOjIwNzM0ODE4MjgsInN1YiI6IjY4YzgyYzYzZmU0OTdjMDU2ZjM1NjkyNCIsInNjb3BlcyI6W119.ar6hVJ0W_rmBdukF5xkdIpLdGw6JZAvnmAaCL1vvbDJYiRwuQ8nHeaiKdIYWk-E5pz_IGNoCfTGG1R4K9nfBBlZd26bQ8KgCqpOBFuNaCb1mGJLhKxNEs73O1DqD5GaKotOA0qdnqUYYRXRu4Fc1FDlmNjzyiVmB5rFt9GYxT8iTPyAFv_eLfwBYikNOMr6SmyagRVvqpgNsLYkk4NXn14CO3Cs4L-BglWZrVveFgKhf5F9KMRrdN54yrTP5zxvyqgmnGoxMJ4o0nlpJYMhqygL7mza-WygWGxG-tAo0gGXhQDsi0jD65k5VjkzJOaZUNy01N2lntikm4N1Wqts98yHBo-AO7uUFxLxJee3ni2w5fX-24ZVxK8KjyvA0bASzfueZEHugYf9-WNJ0ijKcLZmg9WiZQr72zs7lWTsiNUlHyNuUXd1d76G3hDH7wGyFCw_7U44Cd2m164fhzhl3PnCKyJeoHhZ-xIA6L7Lo4K6L55rcLiEoYOh2LuObQKhMOHSF5bMEpQywriD2sm2gP_FvKYD7JkUD3fAJqLw7UWDcAJu-TFsTwDcp8helGkzHd0HN3pvt2rUyqRVXn-YRZxytvrVA4Wr9ekOrBviPW43tndp3-uac1gb-2GIqLiYxLNqyyzXzNf0L-vnzD2VUcihonPQ2C_mnizkrqWr94iQ

Body

application/json

objectOptional

Responses

200

OK

application/json

422

Unprocessable Entity (WebDAV)

application/json

get

/availability/occurrences

HTTPcURLJavaScriptPython

GET /v1/availability/occurrences?event_brand=68c2a1aba911520a75279f14&start_date=2030-01-01&end_date=2030-02-01 HTTP/1.1
Host: api-qa.tonicticketing.com
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "data": [
    {
      "id": "59df9c1ecfbbaf34d94732c9",
      "event_title": "Sean's Event",
      "date": "2023-10-21",
      "is_sold_out": true,
      "cancelled": true,
      "sell_until": "2023-09-21 00:00:00",
      "sell_from": "2022-02-21 00:00:00",
      "end_date": "2023-11-10",
      "start_time": "19:00",
      "end_time": "21:00",
      "total_tickets_ever_available": 1000,
      "total_ticket_sales": 100,
      "total_ticket_guests": 20,
      "total_ticket_attendees": 80
    }
  ]
}

Get a specific occurrence

get

https://api-qa.tonicticketing.com/v1https://api-demo.tonicticketing.com/v1https://api.tonicticketing.com/v1

/availability/events/{event}/occurrences/{date}

Get details about a single occurrence including ticket types

Path parameters

datestring · dateRequired

Date in YYYY-MM-DD format

Example: 2030-01-04Pattern: ^\d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])$

eventstringRequired

ID of the event

Example: 68c2a232a911520b6905c365Pattern: ^[a-f\d]{24}$

Header parameters

authorizationstringRequired

Contains bearer followed by bearer token

Example: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjgxZjNhZTUyZDVmYzJkNzEwM2VmMDNjN2UwOThiOTA4NmE1NDE0M2M0M2Y0ODBmMThjYmI4NTI0ODI0Y2U5MmY0YWFjZjhiN2Q5ZDZlNWU2In0.eyJhdWQiOiI1OWU3MjljNTJmOGU5ZDYyZTg3ZmMwNTIiLCJqdGkiOiI4MWYzYWU1MmQ1ZmMyZDcxMDNlZjAzYzdlMDk4YjkwODZhNTQxNDNjNDNmNDgwZjE4Y2JiODUyNDgyNGNlOTJmNGFhY2Y4YjdkOWQ2ZTVlNiIsImlhdCI6MTc1Nzk0OTAyOCwibmJmIjoxNzU3OTQ5MDI4LCJleHAiOjIwNzM0ODE4MjgsInN1YiI6IjY4YzgyYzYzZmU0OTdjMDU2ZjM1NjkyNCIsInNjb3BlcyI6W119.ar6hVJ0W_rmBdukF5xkdIpLdGw6JZAvnmAaCL1vvbDJYiRwuQ8nHeaiKdIYWk-E5pz_IGNoCfTGG1R4K9nfBBlZd26bQ8KgCqpOBFuNaCb1mGJLhKxNEs73O1DqD5GaKotOA0qdnqUYYRXRu4Fc1FDlmNjzyiVmB5rFt9GYxT8iTPyAFv_eLfwBYikNOMr6SmyagRVvqpgNsLYkk4NXn14CO3Cs4L-BglWZrVveFgKhf5F9KMRrdN54yrTP5zxvyqgmnGoxMJ4o0nlpJYMhqygL7mza-WygWGxG-tAo0gGXhQDsi0jD65k5VjkzJOaZUNy01N2lntikm4N1Wqts98yHBo-AO7uUFxLxJee3ni2w5fX-24ZVxK8KjyvA0bASzfueZEHugYf9-WNJ0ijKcLZmg9WiZQr72zs7lWTsiNUlHyNuUXd1d76G3hDH7wGyFCw_7U44Cd2m164fhzhl3PnCKyJeoHhZ-xIA6L7Lo4K6L55rcLiEoYOh2LuObQKhMOHSF5bMEpQywriD2sm2gP_FvKYD7JkUD3fAJqLw7UWDcAJu-TFsTwDcp8helGkzHd0HN3pvt2rUyqRVXn-YRZxytvrVA4Wr9ekOrBviPW43tndp3-uac1gb-2GIqLiYxLNqyyzXzNf0L-vnzD2VUcihonPQ2C_mnizkrqWr94iQ

Responses

200

OK

application/json

404

Not Found

get

/availability/events/{event}/occurrences/{date}

HTTPcURLJavaScriptPython

GET /v1/availability/events/{event}/occurrences/{date} HTTP/1.1
Host: api-qa.tonicticketing.com
authorization: text
Accept: */*

{
  "data": {
    "date": "2023-01-01",
    "is_sold_out": true,
    "cancelled": true,
    "ticket_types": [
      {
        "id": "string",
        "name": "string",
        "ticket_type_group": "string",
        "available_quantity": 0,
        "min_per_transaction": 0,
        "max_per_transaction": 0,
        "remaining_quantity": 100,
        "fixed_quantities_per_purchase": 0,
        "sell_until": "2022-10-21 00:00:00",
        "sell_from": "2019-10-21 00:00:00",
        "price": [
          {
            "amount": 1000,
            "currency": "GBP"
          }
        ],
        "start_time": "17:00",
        "end_time": "23:00"
      }
    ],
    "ticket_type_groups": [
      {
        "id": "text",
        "name": "text",
        "available_quantity": 1
      }
    ],
    "sell_from": "text",
    "sell_until": "text",
    "start_time": "17:00",
    "end_time": "23:00"
  }
}

Create a cart

post

https://api-qa.tonicticketing.com/v1https://api-demo.tonicticketing.com/v1https://api.tonicticketing.com/v1

/carts

Header parameters

authorizationstringRequired

Contains bearer followed by bearer token

Example: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImp0aSI6IjgxZjNhZTUyZDVmYzJkNzEwM2VmMDNjN2UwOThiOTA4NmE1NDE0M2M0M2Y0ODBmMThjYmI4NTI0ODI0Y2U5MmY0YWFjZjhiN2Q5ZDZlNWU2In0.eyJhdWQiOiI1OWU3MjljNTJmOGU5ZDYyZTg3ZmMwNTIiLCJqdGkiOiI4MWYzYWU1MmQ1ZmMyZDcxMDNlZjAzYzdlMDk4YjkwODZhNTQxNDNjNDNmNDgwZjE4Y2JiODUyNDgyNGNlOTJmNGFhY2Y4YjdkOWQ2ZTVlNiIsImlhdCI6MTc1Nzk0OTAyOCwibmJmIjoxNzU3OTQ5MDI4LCJleHAiOjIwNzM0ODE4MjgsInN1YiI6IjY4YzgyYzYzZmU0OTdjMDU2ZjM1NjkyNCIsInNjb3BlcyI6W119.ar6hVJ0W_rmBdukF5xkdIpLdGw6JZAvnmAaCL1vvbDJYiRwuQ8nHeaiKdIYWk-E5pz_IGNoCfTGG1R4K9nfBBlZd26bQ8KgCqpOBFuNaCb1mGJLhKxNEs73O1DqD5GaKotOA0qdnqUYYRXRu4Fc1FDlmNjzyiVmB5rFt9GYxT8iTPyAFv_eLfwBYikNOMr6SmyagRVvqpgNsLYkk4NXn14CO3Cs4L-BglWZrVveFgKhf5F9KMRrdN54yrTP5zxvyqgmnGoxMJ4o0nlpJYMhqygL7mza-WygWGxG-tAo0gGXhQDsi0jD65k5VjkzJOaZUNy01N2lntikm4N1Wqts98yHBo-AO7uUFxLxJee3ni2w5fX-24ZVxK8KjyvA0bASzfueZEHugYf9-WNJ0ijKcLZmg9WiZQr72zs7lWTsiNUlHyNuUXd1d76G3hDH7wGyFCw_7U44Cd2m164fhzhl3PnCKyJeoHhZ-xIA6L7Lo4K6L55rcLiEoYOh2LuObQKhMOHSF5bMEpQywriD2sm2gP_FvKYD7JkUD3fAJqLw7UWDcAJu-TFsTwDcp8helGkzHd0HN3pvt2rUyqRVXn-YRZxytvrVA4Wr9ekOrBviPW43tndp3-uac1gb-2GIqLiYxLNqyyzXzNf0L-vnzD2VUcihonPQ2C_mnizkrqWr94iQ

Body

application/json

sourcestringOptionalExample: partner

Responses

200

OK

application/json

400

Bad Request

application/json

422

Unprocessable Entity (WebDAV)

application/jsonapplication/xml

post

/carts

HTTPcURLJavaScriptPython

POST /v1/carts HTTP/1.1
Host: api-qa.tonicticketing.com
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "items": [
    {
      "item_id": "68c2a232a911520b6905c365",
      "sub_type": "68c2a21aa911520b6103ebc5",
      "quantity": 3,
      "date": "2030-01-04"
    }
  ],
  "source": "partner"
}

{
  "data": {
    "_id": "text",
    "created_date": "text",
    "last_updated": "text",
    "purchase_id": 1,
    "user_id": "text",
    "total_cost": 1,
    "payments": [
      {}
    ],
    "source": "text",
    "status": "text",
    "currency": "text",
    "item_id": "text",
    "item_date": "text",
    "affiliate_id": "text",
    "address": null,
    "checkout_questions": [
      {}
    ],
    "reservation_details": null,
    "refund_request": [
      {}
    ],
    "items": [
      {
        "_id": "text",
        "item_id": "text",
        "name": "text",
        "type": "text",
        "sub_type": "text",
        "sub_type_name": "text",
        "multi_day_ticket": true,
        "date": "text",
        "quantity": 1,
        "unit_price": 1,
        "admin_fee": 1,
        "rep_id": true,
        "affiliate_id": "text",
        "purchase_item_type": "text",
        "currency": "text",
        "cart": {
          "_id": "text",
          "created_date": "text",
          "last_updated": "text",
          "purchase_id": 1,
          "user_id": "text",
          "total_cost": 1,
          "payments": [
            {}
          ],
          "source": "text",
          "status": "text",
          "currency": "text",
          "item_id": "text",
          "item_date": "text",
          "affiliate_id": "text",
          "address": null,
          "checkout_questions": [
            {}
          ],
          "reservation_details": null,
          "refund_request": [
            {}
          ]
        },
        "ticket_list": [
          {
            "_id": "text",
            "reference": 1,
            "checked_in": null,
            "checked_in_by": "text"
          }
        ]
      }
    ]
  },
  "responseTime": "text",
  "meta": {
    "checkout_url": "text"
  }
}