Customer API Reference
The Customer API allows your customers to purchase tickets. It supports creating a cart, adding line items, checking out, and retrieving the resulting order.
A typical workflow is to create a new Cart with at least one Cart Line item, providing the Customer's first and last names, phone number, and email address. In order to present ticket options for purchase, the Customer API also provides details of all Events, Venues, Sessions, Ticket Types, and Session Ticket Types (a Ticket Type offered for a specific Session). It also supports providing details of your Account (including the default currency and locale settings) and available Payment Gateways.
Once a transaction has been successfully completed, the Customer API also supports downloading the detail of the Order and associated Tickets.
Separate to the Customer API, the Admin API can be used to configure every aspect of your ticketing setup, and to retrieve customer and transaction data.
Terms of Service
API Endpoints
# Customer API:
https://[your-mightytix-domain]/customer-api/graphql
Authentication
No authentication is needed for the Customer API. Anyone can
create a new Cart, but the returned Cart
id must be specified for all subsequent Cart
manipulation operations.
Queries
account
Response
Returns an
Account!
Example
Query
query Account {
account {
currency
locale
name
url
}
}
Response
{
"data": {
"account": {
"currency": "USD",
"locale": "en-US",
"name": "Stark Industries",
"url": "stark.example.com"
}
}
}
cart
Example
Query
query Cart($id: ID!) {
cart(id: $id) {
acceptsMarketing
bookingFees
cartLines {
bookingFees
cart {
...CartFragment
}
id
quantity
sessionTicketType {
...SessionTicketTypeFragment
}
subtotal
}
email
expires
firstName
id
lastName
paymentFees
paymentIntentClientSecret
phone
subtotal
total
}
}
Variables
{"id": 4}
Response
{
"data": {
"cart": {
"acceptsMarketing": true,
"bookingFees": "123.45",
"cartLines": [CartLine],
"email": "john.doe@example.com",
"expires": "2023-01-01T00:00:00.000Z",
"firstName": "John",
"id": "4",
"lastName": "Doe",
"paymentFees": "123.45",
"paymentIntentClientSecret": "xyz789",
"phone": "(555) 123-4567",
"subtotal": "123.45",
"total": "123.45"
}
}
}
event
Example
Query
query Event($id: ID!) {
event(id: $id) {
descriptionHtml
id
name
sessions {
edges {
...SessionEdgeFragment
}
pageInfo {
...PageInfoFragment
}
}
}
}
Variables
{"id": 4}
Response
{
"data": {
"event": {
"descriptionHtml": "<p>The event description.</p>",
"id": 4,
"name": "The Event Name",
"sessions": EventSessionsConnection
}
}
}
events
Response
Returns an
EventConnection!
Arguments
| Name | Description |
|---|---|
filter
-
EventFilter
|
Specify to filter the records returned. Default =
{}
|
paging
-
CursorPaging
|
Limit or page results. Default =
{first: 10}
|
sorting
-
[EventSort!]
|
Specify to sort results. Default =
[{direction: ASC, field: name}]
|
Example
Query
query Events(
$filter: EventFilter,
$paging: CursorPaging,
$sorting: [EventSort!]
) {
events(
filter: $filter,
paging: $paging,
sorting: $sorting
) {
edges {
cursor
node {
...EventFragment
}
}
pageInfo {
endCursor
hasNextPage
hasPreviousPage
startCursor
}
}
}
Variables
{
"filter": {},
"paging": {"first": 10},
"sorting": [{"direction": "ASC", "field": "name"}]
}
Response
{
"data": {
"events": {
"edges": [EventEdge],
"pageInfo": PageInfo
}
}
}
order
Example
Query
query Order($id: ID!) {
order(id: $id) {
acceptsMarketing
bookingFees
cardExpMonth
cardExpYear
cardLast4
cardNetwork
email
firstName
id
lastName
originalBookingFees
originalPaymentFees
originalSubtotal
originalTotal
paymentFees
paymentIntentId
paymentStatus
phone
processed
publicId
subtotal
tickets {
bookingFee
id
number
order {
...OrderFragment
}
price
sessionTicketType {
...SessionTicketTypeFragment
}
}
total
}
}
Variables
{"id": "4"}
Response
{
"data": {
"order": {
"acceptsMarketing": false,
"bookingFees": "123.45",
"cardExpMonth": 123.45,
"cardExpYear": 987.65,
"cardLast4": 987.65,
"cardNetwork": "xyz789",
"email": "abc123",
"firstName": "xyz789",
"id": "4",
"lastName": "xyz789",
"originalBookingFees": "123.45",
"originalPaymentFees": "123.45",
"originalSubtotal": "123.45",
"originalTotal": "123.45",
"paymentFees": "123.45",
"paymentIntentId": "abc123",
"paymentStatus": "PAID",
"phone": "xyz789",
"processed": "2023-01-01T00:00:00.000Z",
"publicId": "abc123",
"subtotal": "123.45",
"tickets": [Ticket],
"total": "123.45"
}
}
}
orders
Response
Returns an
OrderConnection!
Arguments
| Name | Description |
|---|---|
filter
-
OrderFilter!
|
Specify to filter the records returned. |
paging
-
CursorPaging
|
Limit or page results. Default =
{first: 10}
|
sorting
-
[OrderSort!]
|
Specify to sort results. Default = []
|
Example
Query
query Orders(
$filter: OrderFilter!,
$paging: CursorPaging,
$sorting: [OrderSort!]
) {
orders(
filter: $filter,
paging: $paging,
sorting: $sorting
) {
edges {
cursor
node {
...OrderFragment
}
}
pageInfo {
endCursor
hasNextPage
hasPreviousPage
startCursor
}
}
}
Variables
{
"filter": OrderFilter,
"paging": {"first": 10},
"sorting": [""]
}
Response
{
"data": {
"orders": {
"edges": [OrderEdge],
"pageInfo": PageInfo
}
}
}
paymentGateways
Response
Returns a
PaymentGatewayConnection!
Arguments
| Name | Description |
|---|---|
filter
-
PaymentGatewayFilter
|
Specify to filter the records returned. Default =
{}
|
paging
-
CursorPaging
|
Limit or page results. Default =
{first: 10}
|
sorting
-
[PaymentGatewaySort!]
|
Specify to sort results. Default = []
|
Example
Query
query PaymentGateways(
$filter: PaymentGatewayFilter,
$paging: CursorPaging,
$sorting: [PaymentGatewaySort!]
) {
paymentGateways(
filter: $filter,
paging: $paging,
sorting: $sorting
) {
edges {
cursor
node {
...PaymentGatewayFragment
}
}
pageInfo {
endCursor
hasNextPage
hasPreviousPage
startCursor
}
}
}
Variables
{"filter": {}, "paging": {"first": 10}, "sorting": [""]}
Response
{
"data": {
"paymentGateways": {
"edges": [PaymentGatewayEdge],
"pageInfo": PageInfo
}
}
}
session
Example
Query
query Session($id: ID!) {
session(id: $id) {
capacity
doors
end
event {
descriptionHtml
id
name
sessions {
...EventSessionsConnectionFragment
}
}
eventId
id
offsale
onsale
sessionTicketTypes {
bookingFee
capacity
enabled
price
session {
...SessionFragment
}
sessionId
ticketType {
...TicketTypeFragment
}
ticketTypeId
}
start
venue {
address
city
country
id
latLong
name
postalCode
space
state
suburb
timezone
}
}
}
Variables
{"id": 4}
Response
{
"data": {
"session": {
"capacity": 123,
"doors": "2023-01-01T00:00:00.000Z",
"end": "2023-01-01T00:00:00.000Z",
"event": Event,
"eventId": "xyz789",
"id": 4,
"offsale": "2023-01-01T00:00:00.000Z",
"onsale": "2023-01-01T00:00:00.000Z",
"sessionTicketTypes": SessionTicketType,
"start": "2023-01-01T00:00:00.000Z",
"venue": Venue
}
}
}
sessionTicketType
Response
Returns a
SessionTicketType
Arguments
| Name | Description |
|---|---|
id -
ID!
|
The id of the record to find. |
Example
Query
query SessionTicketType($id: ID!) {
sessionTicketType(id: $id) {
bookingFee
capacity
enabled
price
session {
capacity
doors
end
event {
...EventFragment
}
eventId
id
offsale
onsale
sessionTicketTypes {
...SessionTicketTypeFragment
}
start
venue {
...VenueFragment
}
}
sessionId
ticketType {
bookingFee
id
name
price
sessionTicketTypes {
...SessionTicketTypeFragment
}
sort
}
ticketTypeId
}
}
Variables
{"id": "4"}
Response
{
"data": {
"sessionTicketType": {
"bookingFee": "123.45",
"capacity": 987,
"enabled": true,
"price": "123.45",
"session": Session,
"sessionId": "4",
"ticketType": TicketType,
"ticketTypeId": "4"
}
}
}
sessionTicketTypes
Response
Returns a
SessionTicketTypeConnection!
Arguments
| Name | Description |
|---|---|
filter
-
SessionTicketTypeFilter
|
Specify to filter the records returned. Default =
{}
|
paging
-
CursorPaging
|
Limit or page results. Default =
{first: 10}
|
sorting
-
[SessionTicketTypeSort!]
|
Specify to sort results. Default = []
|
Example
Query
query SessionTicketTypes(
$filter: SessionTicketTypeFilter,
$paging: CursorPaging,
$sorting: [SessionTicketTypeSort!]
) {
sessionTicketTypes(
filter: $filter,
paging: $paging,
sorting: $sorting
) {
edges {
cursor
node {
...SessionTicketTypeFragment
}
}
pageInfo {
endCursor
hasNextPage
hasPreviousPage
startCursor
}
}
}
Variables
{"filter": {}, "paging": {"first": 10}, "sorting": [""]}
Response
{
"data": {
"sessionTicketTypes": {
"edges": [SessionTicketTypeEdge],
"pageInfo": PageInfo
}
}
}
sessions
Response
Returns a
SessionConnection!
Arguments
| Name | Description |
|---|---|
filter
-
SessionFilter
|
Specify to filter the records returned. Default =
{}
|
paging
-
CursorPaging
|
Limit or page results. Default =
{first: 10}
|
sorting
-
[SessionSort!]
|
Specify to sort results. Default =
[{direction: ASC, field: start}]
|
Example
Query
query Sessions(
$filter: SessionFilter,
$paging: CursorPaging,
$sorting: [SessionSort!]
) {
sessions(
filter: $filter,
paging: $paging,
sorting: $sorting
) {
edges {
cursor
node {
...SessionFragment
}
}
pageInfo {
endCursor
hasNextPage
hasPreviousPage
startCursor
}
}
}
Variables
{
"filter": {},
"paging": {"first": 10},
"sorting": [{"direction": "ASC", "field": "start"}]
}
Response
{
"data": {
"sessions": {
"edges": [SessionEdge],
"pageInfo": PageInfo
}
}
}
ticketType
Response
Returns a
TicketType
Arguments
| Name | Description |
|---|---|
id -
ID!
|
The id of the record to find. |
Example
Query
query TicketType($id: ID!) {
ticketType(id: $id) {
bookingFee
id
name
price
sessionTicketTypes {
bookingFee
capacity
enabled
price
session {
...SessionFragment
}
sessionId
ticketType {
...TicketTypeFragment
}
ticketTypeId
}
sort
}
}
Variables
{"id": "4"}
Response
{
"data": {
"ticketType": {
"bookingFee": "123.45",
"id": 4,
"name": "xyz789",
"price": "123.45",
"sessionTicketTypes": [SessionTicketType],
"sort": 987
}
}
}
ticketTypes
Response
Returns a
TicketTypeConnection!
Arguments
| Name | Description |
|---|---|
filter
-
TicketTypeFilter
|
Specify to filter the records returned. Default =
{}
|
paging
-
CursorPaging
|
Limit or page results. Default =
{first: 10}
|
sorting
-
[TicketTypeSort!]
|
Specify to sort results. Default =
[{direction: ASC, field: sort}, {direction: ASC,
field: name}]
|
Example
Query
query TicketTypes(
$filter: TicketTypeFilter,
$paging: CursorPaging,
$sorting: [TicketTypeSort!]
) {
ticketTypes(
filter: $filter,
paging: $paging,
sorting: $sorting
) {
edges {
cursor
node {
...TicketTypeFragment
}
}
pageInfo {
endCursor
hasNextPage
hasPreviousPage
startCursor
}
}
}
Variables
{
"filter": {},
"paging": {"first": 10},
"sorting": [
{"direction": "ASC", "field": "sort"},
{"direction": "ASC", "field": "name"}
]
}
Response
{
"data": {
"ticketTypes": {
"edges": [TicketTypeEdge],
"pageInfo": PageInfo
}
}
}
venue
Example
Query
query Venue($id: ID!) {
venue(id: $id) {
address
city
country
id
latLong
name
postalCode
space
state
suburb
timezone
}
}
Variables
{"id": 4}
Response
{
"data": {
"venue": {
"address": "xyz789",
"city": "xyz789",
"country": "abc123",
"id": 4,
"latLong": "abc123",
"name": "abc123",
"postalCode": "xyz789",
"space": "abc123",
"state": "abc123",
"suburb": "abc123",
"timezone": "abc123"
}
}
}
venues
Response
Returns a
VenueConnection!
Arguments
| Name | Description |
|---|---|
filter
-
VenueFilter
|
Specify to filter the records returned. Default =
{}
|
paging
-
CursorPaging
|
Limit or page results. Default =
{first: 10}
|
sorting
-
[VenueSort!]
|
Specify to sort results. Default =
[{direction: ASC, field: name}, {direction: ASC,
field: space}]
|
Example
Query
query Venues(
$filter: VenueFilter,
$paging: CursorPaging,
$sorting: [VenueSort!]
) {
venues(
filter: $filter,
paging: $paging,
sorting: $sorting
) {
edges {
cursor
node {
...VenueFragment
}
}
pageInfo {
endCursor
hasNextPage
hasPreviousPage
startCursor
}
}
}
Variables
{
"filter": {},
"paging": {"first": 10},
"sorting": [
{"direction": "ASC", "field": "name"},
{"direction": "ASC", "field": "space"}
]
}
Response
{
"data": {
"venues": {
"edges": [VenueEdge],
"pageInfo": PageInfo
}
}
}
Mutations
createCart
Response
Returns a
Cart!
Arguments
| Name | Description |
|---|---|
input
-
CreateOneCartInput!
|
Example
Query
mutation CreateCart($input: CreateOneCartInput!) {
createCart(input: $input) {
acceptsMarketing
bookingFees
cartLines {
bookingFees
cart {
...CartFragment
}
id
quantity
sessionTicketType {
...SessionTicketTypeFragment
}
subtotal
}
email
expires
firstName
id
lastName
paymentFees
paymentIntentClientSecret
phone
subtotal
total
}
}
Variables
{"input": CreateOneCartInput}
Response
{
"data": {
"createCart": {
"acceptsMarketing": true,
"bookingFees": "123.45",
"cartLines": [CartLine],
"email": "john.doe@example.com",
"expires": "2023-01-01T00:00:00.000Z",
"firstName": "John",
"id": 4,
"lastName": "Doe",
"paymentFees": "123.45",
"paymentIntentClientSecret": "abc123",
"phone": "(555) 123-4567",
"subtotal": "123.45",
"total": "123.45"
}
}
}
createPaymentIntent
Example
Query
mutation CreatePaymentIntent($cartId: String!) {
createPaymentIntent(cartId: $cartId) {
acceptsMarketing
bookingFees
cartLines {
bookingFees
cart {
...CartFragment
}
id
quantity
sessionTicketType {
...SessionTicketTypeFragment
}
subtotal
}
email
expires
firstName
id
lastName
paymentFees
paymentIntentClientSecret
phone
subtotal
total
}
}
Variables
{"cartId": "abc123"}
Response
{
"data": {
"createPaymentIntent": {
"acceptsMarketing": true,
"bookingFees": "123.45",
"cartLines": [CartLine],
"email": "john.doe@example.com",
"expires": "2023-01-01T00:00:00.000Z",
"firstName": "John",
"id": "4",
"lastName": "Doe",
"paymentFees": "123.45",
"paymentIntentClientSecret": "xyz789",
"phone": "(555) 123-4567",
"subtotal": "123.45",
"total": "123.45"
}
}
}
deleteCart
Response
Returns a
CartDeleteResponse!
Arguments
| Name | Description |
|---|---|
input
-
DeleteOneCartInput!
|
Example
Query
mutation DeleteCart($input: DeleteOneCartInput!) {
deleteCart(input: $input) {
acceptsMarketing
bookingFees
email
expires
firstName
id
lastName
paymentFees
paymentIntentClientSecret
phone
subtotal
total
}
}
Variables
{"input": DeleteOneCartInput}
Response
{
"data": {
"deleteCart": {
"acceptsMarketing": false,
"bookingFees": "123.45",
"email": "abc123",
"expires": "2023-01-01T00:00:00.000Z",
"firstName": "xyz789",
"id": "4",
"lastName": "abc123",
"paymentFees": "123.45",
"paymentIntentClientSecret": "xyz789",
"phone": "abc123",
"subtotal": "123.45",
"total": "123.45"
}
}
}
setCartLine
Response
Returns a
Cart!
Arguments
| Name | Description |
|---|---|
input
-
SetCartLineInput!
|
Example
Query
mutation SetCartLine($input: SetCartLineInput!) {
setCartLine(input: $input) {
acceptsMarketing
bookingFees
cartLines {
bookingFees
cart {
...CartFragment
}
id
quantity
sessionTicketType {
...SessionTicketTypeFragment
}
subtotal
}
email
expires
firstName
id
lastName
paymentFees
paymentIntentClientSecret
phone
subtotal
total
}
}
Variables
{"input": SetCartLineInput}
Response
{
"data": {
"setCartLine": {
"acceptsMarketing": false,
"bookingFees": "123.45",
"cartLines": [CartLine],
"email": "john.doe@example.com",
"expires": "2023-01-01T00:00:00.000Z",
"firstName": "John",
"id": "4",
"lastName": "Doe",
"paymentFees": "123.45",
"paymentIntentClientSecret": "xyz789",
"phone": "(555) 123-4567",
"subtotal": "123.45",
"total": "123.45"
}
}
}
updateCart
Response
Returns a
Cart!
Arguments
| Name | Description |
|---|---|
input
-
UpdateOneCartInput!
|
Example
Query
mutation UpdateCart($input: UpdateOneCartInput!) {
updateCart(input: $input) {
acceptsMarketing
bookingFees
cartLines {
bookingFees
cart {
...CartFragment
}
id
quantity
sessionTicketType {
...SessionTicketTypeFragment
}
subtotal
}
email
expires
firstName
id
lastName
paymentFees
paymentIntentClientSecret
phone
subtotal
total
}
}
Variables
{"input": UpdateOneCartInput}
Response
{
"data": {
"updateCart": {
"acceptsMarketing": true,
"bookingFees": "123.45",
"cartLines": [CartLine],
"email": "john.doe@example.com",
"expires": "2023-01-01T00:00:00.000Z",
"firstName": "John",
"id": "4",
"lastName": "Doe",
"paymentFees": "123.45",
"paymentIntentClientSecret": "xyz789",
"phone": "(555) 123-4567",
"subtotal": "123.45",
"total": "123.45"
}
}
}
Types
Account
Description
The account represents your organisation.
Example
{
"currency": "USD",
"locale": "en-US",
"name": "Stark Industries",
"url": "stark.example.com"
}
Boolean
Description
The Boolean scalar type represents
true or false.
Example
true
BooleanFieldComparison
Cart
Description
A cart represents items to be purchased.
Fields
| Field Name | Description |
|---|---|
acceptsMarketing
-
Boolean!
|
Whether the customer has consented to future marketing communications. |
bookingFees
-
Money!
|
The estimated booking fees. |
cartLines
-
[CartLine!]!
|
|
Arguments
|
|
email
-
String
|
The email address of the customer. |
expires
-
DateTime!
|
When the cart expires. |
firstName
-
String
|
The first name of the customer. |
id -
ID!
|
The ID of the cart. |
lastName
-
String
|
The last name of the customer. |
paymentFees
-
Money!
|
The estimated payment processing fees. |
paymentIntentClientSecret
-
String
|
The payment gateway's payment intent client secret. |
phone
-
String
|
The phone number of the customer. |
subtotal
-
Money!
|
The estimated subtotal amount before fees and discounts. |
total
-
Money!
|
The estimated total amount for the customer to pay. |
Example
{
"acceptsMarketing": false,
"bookingFees": "123.45",
"cartLines": [CartLine],
"email": "john.doe@example.com",
"expires": "2023-01-01T00:00:00.000Z",
"firstName": "John",
"id": "4",
"lastName": "Doe",
"paymentFees": "123.45",
"paymentIntentClientSecret": "abc123",
"phone": "(555) 123-4567",
"subtotal": "123.45",
"total": "123.45"
}
CartDeleteResponse
Fields
| Field Name | Description |
|---|---|
acceptsMarketing
-
Boolean
|
Whether the customer has consented to future marketing communications. |
bookingFees
-
Money
|
The estimated booking fees. |
email
-
String
|
The email address of the customer. |
expires
-
DateTime
|
When the cart expires. |
firstName
-
String
|
The first name of the customer. |
id -
ID
|
The ID of the cart. |
lastName
-
String
|
The last name of the customer. |
paymentFees
-
Money
|
The estimated payment processing fees. |
paymentIntentClientSecret
-
String
|
The payment gateway's payment intent client secret. |
phone
-
String
|
The phone number of the customer. |
subtotal
-
Money
|
The estimated subtotal amount before fees and discounts. |
total
-
Money
|
The estimated total amount for the customer to pay. |
Example
{
"acceptsMarketing": false,
"bookingFees": "123.45",
"email": "abc123",
"expires": "2023-01-01T00:00:00.000Z",
"firstName": "xyz789",
"id": "4",
"lastName": "abc123",
"paymentFees": "123.45",
"paymentIntentClientSecret": "xyz789",
"phone": "abc123",
"subtotal": "123.45",
"total": "123.45"
}
CartLine
Description
A cart line represents information about a session ticket type in the cart.
Example
{
"bookingFees": "123.45",
"cart": Cart,
"id": 4,
"quantity": 987,
"sessionTicketType": SessionTicketType,
"subtotal": "123.45"
}
CartLineFilter
Fields
| Input Field | Description |
|---|---|
and -
[CartLineFilter!]
|
|
id -
IDFilterComparison
|
|
or -
[CartLineFilter!]
|
Example
{
"and": [CartLineFilter],
"id": IDFilterComparison,
"or": [CartLineFilter]
}
CartLineInput
CartLineSort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
CartLineSortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "id", "nulls": "NULLS_FIRST"}
CartLineSortFields
Values
| Enum Value | Description |
|---|---|
|
|
Example
"id"
ConnectionCursor
Description
Cursor for paging through collections
Example
ConnectionCursor
CreateCartInput
Description
The inputs for creating a cart.
Fields
| Input Field | Description |
|---|---|
acceptsMarketing
-
Boolean
|
Whether the customer has consented to future marketing communications. |
cartLines
-
[CartLineInput!]
|
|
email
-
String
|
The email address of the customer. |
firstName
-
String
|
The first name of the customer. |
lastName
-
String
|
The last name of the customer. |
phone
-
String
|
The phone number of the customer. |
Example
{
"acceptsMarketing": true,
"cartLines": [CartLineInput],
"email": "abc123",
"firstName": "abc123",
"lastName": "abc123",
"phone": "xyz789"
}
CreateOneCartInput
Fields
| Input Field | Description |
|---|---|
cart -
CreateCartInput!
|
The record to create |
Example
{"cart": CreateCartInput}
CursorPaging
Fields
| Input Field | Description |
|---|---|
after
-
ConnectionCursor
|
Paginate after opaque cursor |
before
-
ConnectionCursor
|
Paginate before opaque cursor |
first
-
Int
|
Paginate first |
last -
Int
|
Paginate last |
Example
{
"after": ConnectionCursor,
"before": ConnectionCursor,
"first": 123,
"last": 123
}
DateFieldComparison
Fields
| Input Field | Description |
|---|---|
between
-
DateFieldComparisonBetween
|
|
eq -
DateTime
|
|
gt -
DateTime
|
|
gte -
DateTime
|
|
in -
[DateTime!]
|
|
is -
Boolean
|
|
isNot
-
Boolean
|
|
lt -
DateTime
|
|
lte -
DateTime
|
|
neq -
DateTime
|
|
notBetween
-
DateFieldComparisonBetween
|
|
notIn
-
[DateTime!]
|
Example
{
"between": DateFieldComparisonBetween,
"eq": "2023-01-01T00:00:00.000Z",
"gt": "2023-01-01T00:00:00.000Z",
"gte": "2023-01-01T00:00:00.000Z",
"in": ["2023-01-01T00:00:00.000Z"],
"is": false,
"isNot": false,
"lt": "2023-01-01T00:00:00.000Z",
"lte": "2023-01-01T00:00:00.000Z",
"neq": "2023-01-01T00:00:00.000Z",
"notBetween": DateFieldComparisonBetween,
"notIn": ["2023-01-01T00:00:00.000Z"]
}
DateFieldComparisonBetween
DateTime
Description
A date-time string at UTC, such as 2019-12-03T09:54:33Z, compliant with the date-time format.
Example
"2023-01-01T00:00:00.000Z"
DeleteOneCartInput
Fields
| Input Field | Description |
|---|---|
id -
ID!
|
The id of the record to delete. |
Example
{"id": 4}
Event
Description
An event object contains brand and messaging content bringing together one or more sessions, shows or performances.
Fields
| Field Name | Description |
|---|---|
descriptionHtml
-
String
|
The description of the event, with HTML formatting. |
id -
ID!
|
The ID of the event. |
name -
ID!
|
The name of the event. |
sessions
-
EventSessionsConnection!
|
|
Arguments
|
|
Example
{
"descriptionHtml": "<p>The event description.</p>",
"id": "4",
"name": "The Event Name",
"sessions": EventSessionsConnection
}
EventConnection
Fields
| Field Name | Description |
|---|---|
edges
-
[EventEdge!]!
|
Array of edges. |
pageInfo
-
PageInfo!
|
Paging information |
Example
{
"edges": [EventEdge],
"pageInfo": PageInfo
}
EventEdge
Fields
| Field Name | Description |
|---|---|
cursor
-
ConnectionCursor!
|
Cursor for this node. |
node -
Event!
|
The node containing the Event |
Example
{
"cursor": ConnectionCursor,
"node": Event
}
EventFilter
Fields
| Input Field | Description |
|---|---|
and -
[EventFilter!]
|
|
name -
IDFilterComparison
|
|
or -
[EventFilter!]
|
Example
{
"and": [EventFilter],
"name": IDFilterComparison,
"or": [EventFilter]
}
EventSessionsConnection
Fields
| Field Name | Description |
|---|---|
edges
-
[SessionEdge!]!
|
Array of edges. |
pageInfo
-
PageInfo!
|
Paging information |
Example
{
"edges": [SessionEdge],
"pageInfo": PageInfo
}
EventSort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
EventSortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "name", "nulls": "NULLS_FIRST"}
EventSortFields
Values
| Enum Value | Description |
|---|---|
|
|
Example
"name"
Float
Description
The Float scalar type represents signed
double-precision fractional values as specified by
IEEE 754.
Example
987.65
ID
Description
The ID scalar type represents a unique
identifier, often used to refetch an object or as key for a
cache. The ID type appears in a JSON response as a String;
however, it is not intended to be human-readable. When
expected as an input type, any string (such as
"4") or integer (such as
4) input value will be accepted as an ID.
Example
"4"
IDFilterComparison
Example
{
"eq": 4,
"gt": 4,
"gte": "4",
"iLike": "4",
"in": [4],
"is": false,
"isNot": true,
"like": "4",
"lt": 4,
"lte": 4,
"neq": 4,
"notILike": "4",
"notIn": ["4"],
"notLike": "4"
}
Int
Description
The Int scalar type represents non-fractional
signed whole numeric values. Int can represent values
between -(2^31) and 2^31 - 1.
Example
123
IntFieldComparison
Example
{
"between": IntFieldComparisonBetween,
"eq": 987,
"gt": 123,
"gte": 123,
"in": [987],
"is": true,
"isNot": true,
"lt": 987,
"lte": 123,
"neq": 123,
"notBetween": IntFieldComparisonBetween,
"notIn": [123]
}
IntFieldComparisonBetween
Money
Description
A string representing a monetary value.
Example
"123.45"
Order
Description
An order represents a completed transaction.
Fields
| Field Name | Description |
|---|---|
acceptsMarketing
-
Boolean!
|
Whether the customer has consented to future marketing communications. |
bookingFees
-
Money!
|
The current booking fees. |
cardExpMonth
-
Float
|
The original payment card expiry month. |
cardExpYear
-
Float
|
The original payment card expiry year. |
cardLast4
-
Float
|
The original payment card last 4 digits. |
cardNetwork
-
String
|
The original payment card network. |
email
-
String!
|
The email address of the customer. |
firstName
-
String!
|
The first name of the customer. |
id -
ID!
|
A unique identifier. |
lastName
-
String!
|
The last name of the customer. |
originalBookingFees
-
Money!
|
The original booking fees. |
originalPaymentFees
-
Money!
|
The original payment processing fees. |
originalSubtotal
-
Money!
|
The original subtotal amount before fees and discounts. |
originalTotal
-
Money!
|
The original total paid for the order. |
paymentFees
-
Money!
|
The current payment processing fees. |
paymentIntentId
-
String
|
The payment gateway's transaction reference for the order. |
paymentStatus
-
OrderPaymentStatus!
|
The payment status of the order. |
phone
-
String!
|
The phone number of the customer. |
processed
-
DateTime!
|
When the order was created or imported. |
publicId
-
String!
|
A unique alphanumeric identifier for the order. Can be shared with customers to identify their orders. |
subtotal
-
Money!
|
The current subtotal amount before fees and discounts. |
tickets
-
[Ticket!]!
|
|
Arguments
|
|
total
-
Money!
|
The current total paid for the order. |
Example
{
"acceptsMarketing": false,
"bookingFees": "123.45",
"cardExpMonth": 123.45,
"cardExpYear": 987.65,
"cardLast4": 987.65,
"cardNetwork": "abc123",
"email": "abc123",
"firstName": "abc123",
"id": 4,
"lastName": "abc123",
"originalBookingFees": "123.45",
"originalPaymentFees": "123.45",
"originalSubtotal": "123.45",
"originalTotal": "123.45",
"paymentFees": "123.45",
"paymentIntentId": "abc123",
"paymentStatus": "PAID",
"phone": "abc123",
"processed": "2023-01-01T00:00:00.000Z",
"publicId": "abc123",
"subtotal": "123.45",
"tickets": [Ticket],
"total": "123.45"
}
OrderConnection
Fields
| Field Name | Description |
|---|---|
edges
-
[OrderEdge!]!
|
Array of edges. |
pageInfo
-
PageInfo!
|
Paging information |
Example
{
"edges": [OrderEdge],
"pageInfo": PageInfo
}
OrderEdge
Fields
| Field Name | Description |
|---|---|
cursor
-
ConnectionCursor!
|
Cursor for this node. |
node -
Order!
|
The node containing the Order |
Example
{
"cursor": ConnectionCursor,
"node": Order
}
OrderFilter
Fields
| Input Field | Description |
|---|---|
and -
[OrderFilter!]
|
|
id -
IDFilterComparison
|
|
or -
[OrderFilter!]
|
|
paymentIntentId
-
OrderPaymentIntentIdFilterComparison!
|
Example
{
"and": [OrderFilter],
"id": IDFilterComparison,
"or": [OrderFilter],
"paymentIntentId": OrderPaymentIntentIdFilterComparison
}
OrderPaymentIntentIdFilterComparison
Fields
| Input Field | Description |
|---|---|
eq -
String
|
Example
{"eq": "xyz789"}
OrderPaymentStatus
Description
The current payment status of an order.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"PAID"
OrderSort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
OrderSortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "id", "nulls": "NULLS_FIRST"}
OrderSortFields
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"id"
PageInfo
Fields
| Field Name | Description |
|---|---|
endCursor
-
ConnectionCursor
|
The cursor of the last returned record. |
hasNextPage
-
Boolean
|
true if paging forward and there are more records. |
hasPreviousPage
-
Boolean
|
true if paging backwards and there are more records. |
startCursor
-
ConnectionCursor
|
The cursor of the first returned record. |
Example
{
"endCursor": ConnectionCursor,
"hasNextPage": false,
"hasPreviousPage": true,
"startCursor": ConnectionCursor
}
PaymentGateway
Description
Represents an external payment gateway account and associated payment processing fee amounts.
Example
{
"default": false,
"gatewayAccountId": "xyz789",
"id": 4,
"provider": "xyz789"
}
PaymentGatewayConnection
Fields
| Field Name | Description |
|---|---|
edges
-
[PaymentGatewayEdge!]!
|
Array of edges. |
pageInfo
-
PageInfo!
|
Paging information |
Example
{
"edges": [PaymentGatewayEdge],
"pageInfo": PageInfo
}
PaymentGatewayEdge
Fields
| Field Name | Description |
|---|---|
cursor
-
ConnectionCursor!
|
Cursor for this node. |
node -
PaymentGateway!
|
The node containing the PaymentGateway |
Example
{
"cursor": ConnectionCursor,
"node": PaymentGateway
}
PaymentGatewayFilter
Fields
| Input Field | Description |
|---|---|
and -
[PaymentGatewayFilter!]
|
|
default
-
BooleanFieldComparison
|
|
id -
IDFilterComparison
|
|
or -
[PaymentGatewayFilter!]
|
|
provider
-
StringFieldComparison
|
Example
{
"and": [PaymentGatewayFilter],
"default": BooleanFieldComparison,
"id": IDFilterComparison,
"or": [PaymentGatewayFilter],
"provider": StringFieldComparison
}
PaymentGatewaySort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
PaymentGatewaySortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "default", "nulls": "NULLS_FIRST"}
PaymentGatewaySortFields
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"default"
Session
Description
A session represents the date, time & location of a session, show, or performance of an event.
Fields
| Field Name | Description |
|---|---|
capacity
-
Int
|
The maximum capacity of the session. |
doors
-
DateTime
|
The door opening date and time of the session in UTC. |
end -
DateTime
|
The end date and time of the session in UTC. |
event
-
Event!
|
|
eventId
-
String!
|
The ID of the event the session belongs to. |
id -
ID!
|
The ID of the session. |
offsale
-
DateTime
|
The offsale date and time of the session in UTC. |
onsale
-
DateTime
|
The onsale date and time of the session in UTC. |
sessionTicketTypes
-
SessionTicketType!
|
|
start
-
DateTime!
|
The start date and time of the session in UTC. |
venue
-
Venue!
|
Example
{
"capacity": 123,
"doors": "2023-01-01T00:00:00.000Z",
"end": "2023-01-01T00:00:00.000Z",
"event": Event,
"eventId": "abc123",
"id": 4,
"offsale": "2023-01-01T00:00:00.000Z",
"onsale": "2023-01-01T00:00:00.000Z",
"sessionTicketTypes": SessionTicketType,
"start": "2023-01-01T00:00:00.000Z",
"venue": Venue
}
SessionConnection
Fields
| Field Name | Description |
|---|---|
edges
-
[SessionEdge!]!
|
Array of edges. |
pageInfo
-
PageInfo!
|
Paging information |
Example
{
"edges": [SessionEdge],
"pageInfo": PageInfo
}
SessionEdge
Fields
| Field Name | Description |
|---|---|
cursor
-
ConnectionCursor!
|
Cursor for this node. |
node -
Session!
|
The node containing the Session |
Example
{
"cursor": ConnectionCursor,
"node": Session
}
SessionFilter
Fields
| Input Field | Description |
|---|---|
and -
[SessionFilter!]
|
|
eventId
-
IDFilterComparison
|
|
or -
[SessionFilter!]
|
|
sessionTicketTypes
-
SessionFilterSessionTicketTypeFilter
|
|
start
-
DateFieldComparison
|
Example
{
"and": [SessionFilter],
"eventId": IDFilterComparison,
"or": [SessionFilter],
"sessionTicketTypes": SessionFilterSessionTicketTypeFilter,
"start": DateFieldComparison
}
SessionFilterSessionTicketTypeFilter
Fields
| Input Field | Description |
|---|---|
and -
[SessionFilterSessionTicketTypeFilter!]
|
|
enabled
-
BooleanFieldComparison
|
|
or -
[SessionFilterSessionTicketTypeFilter!]
|
|
sessionId
-
IDFilterComparison
|
|
ticketTypeId
-
IDFilterComparison
|
Example
{
"and": [SessionFilterSessionTicketTypeFilter],
"enabled": BooleanFieldComparison,
"or": [SessionFilterSessionTicketTypeFilter],
"sessionId": IDFilterComparison,
"ticketTypeId": IDFilterComparison
}
SessionSort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
SessionSortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "eventId", "nulls": "NULLS_FIRST"}
SessionSortFields
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"eventId"
SessionTicketType
Description
The session's ticket type association.
Fields
| Field Name | Description |
|---|---|
bookingFee
-
Money
|
The standard price of the ticket type. |
capacity
-
Int
|
The maximum number of the ticket type for the session. |
enabled
-
Boolean!
|
Whether the ticket type is currently enabled for the session. |
price
-
Money
|
The price of the ticket type for the session. |
session
-
Session!
|
|
sessionId
-
ID!
|
The session ID. |
ticketType
-
TicketType!
|
|
ticketTypeId
-
ID!
|
The ticket type ID. |
Example
{
"bookingFee": "123.45",
"capacity": 123,
"enabled": true,
"price": "123.45",
"session": Session,
"sessionId": "4",
"ticketType": TicketType,
"ticketTypeId": "4"
}
SessionTicketTypeConnection
Fields
| Field Name | Description |
|---|---|
edges
-
[SessionTicketTypeEdge!]!
|
Array of edges. |
pageInfo
-
PageInfo!
|
Paging information |
Example
{
"edges": [SessionTicketTypeEdge],
"pageInfo": PageInfo
}
SessionTicketTypeEdge
Fields
| Field Name | Description |
|---|---|
cursor
-
ConnectionCursor!
|
Cursor for this node. |
node -
SessionTicketType!
|
The node containing the SessionTicketType |
Example
{
"cursor": ConnectionCursor,
"node": SessionTicketType
}
SessionTicketTypeFilter
Fields
| Input Field | Description |
|---|---|
and -
[SessionTicketTypeFilter!]
|
|
enabled
-
BooleanFieldComparison
|
|
or -
[SessionTicketTypeFilter!]
|
|
sessionId
-
IDFilterComparison
|
|
ticketTypeId
-
IDFilterComparison
|
Example
{
"and": [SessionTicketTypeFilter],
"enabled": BooleanFieldComparison,
"or": [SessionTicketTypeFilter],
"sessionId": IDFilterComparison,
"ticketTypeId": IDFilterComparison
}
SessionTicketTypeSort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
SessionTicketTypeSortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "enabled", "nulls": "NULLS_FIRST"}
SessionTicketTypeSortFields
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"enabled"
SetCartLineInput
Description
The inputs for setting the information about a cart line.
Example
{
"cartId": "xyz789",
"quantity": 123,
"sessionId": "abc123",
"ticketTypeId": "xyz789"
}
SortDirection
Description
Sort Directions
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"ASC"
SortNulls
Description
Sort Nulls Options
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"NULLS_FIRST"
String
Description
The String scalar type represents textual data,
represented as UTF-8 character sequences. The String type is
most often used by GraphQL to represent free-form
human-readable text.
Example
"abc123"
StringFieldComparison
Example
{
"eq": "xyz789",
"gt": "abc123",
"gte": "abc123",
"iLike": "abc123",
"in": ["abc123"],
"is": true,
"isNot": false,
"like": "abc123",
"lt": "xyz789",
"lte": "abc123",
"neq": "abc123",
"notILike": "xyz789",
"notIn": ["xyz789"],
"notLike": "xyz789"
}
Ticket
Description
The record representing a ticket.
Fields
| Field Name | Description |
|---|---|
bookingFee
-
Money!
|
The booking fee paid for this ticket. |
id -
ID!
|
A unique identifier. |
number
-
Int!
|
A sequential numeric identifier for this ticket within the order. |
order
-
Order!
|
|
price
-
Money!
|
The face value paid for this ticket. |
sessionTicketType
-
SessionTicketType!
|
Example
{
"bookingFee": "123.45",
"id": "4",
"number": 123,
"order": Order,
"price": "123.45",
"sessionTicketType": SessionTicketType
}
TicketFilter
Fields
| Input Field | Description |
|---|---|
and -
[TicketFilter!]
|
|
id -
IDFilterComparison
|
|
or -
[TicketFilter!]
|
Example
{
"and": [TicketFilter],
"id": IDFilterComparison,
"or": [TicketFilter]
}
TicketSort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
TicketSortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "id", "nulls": "NULLS_FIRST"}
TicketSortFields
Values
| Enum Value | Description |
|---|---|
|
|
Example
"id"
TicketType
Description
Ticket type
Fields
| Field Name | Description |
|---|---|
bookingFee
-
Money!
|
The standard price of the ticket type. |
id -
ID!
|
The ID of the ticket type. |
name -
String!
|
The name of the ticket type. |
price
-
Money!
|
The standard price of the ticket type. |
sessionTicketTypes
-
[SessionTicketType!]
|
|
Arguments
|
|
sort -
Int
|
The sort rank of the ticket type. |
Example
{
"bookingFee": "123.45",
"id": "4",
"name": "abc123",
"price": "123.45",
"sessionTicketTypes": [SessionTicketType],
"sort": 123
}
TicketTypeConnection
Fields
| Field Name | Description |
|---|---|
edges
-
[TicketTypeEdge!]!
|
Array of edges. |
pageInfo
-
PageInfo!
|
Paging information |
Example
{
"edges": [TicketTypeEdge],
"pageInfo": PageInfo
}
TicketTypeEdge
Fields
| Field Name | Description |
|---|---|
cursor
-
ConnectionCursor!
|
Cursor for this node. |
node -
TicketType!
|
The node containing the TicketType |
Example
{
"cursor": ConnectionCursor,
"node": TicketType
}
TicketTypeFilter
Fields
| Input Field | Description |
|---|---|
and -
[TicketTypeFilter!]
|
|
id -
IDFilterComparison
|
|
name -
StringFieldComparison
|
|
or -
[TicketTypeFilter!]
|
|
sort -
IntFieldComparison
|
Example
{
"and": [TicketTypeFilter],
"id": IDFilterComparison,
"name": StringFieldComparison,
"or": [TicketTypeFilter],
"sort": IntFieldComparison
}
TicketTypeSort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
TicketTypeSortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "id", "nulls": "NULLS_FIRST"}
TicketTypeSortFields
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"id"
UpdateCartInput
Description
The inputs for updating a cart.
Fields
| Input Field | Description |
|---|---|
acceptsMarketing
-
Boolean
|
Whether the customer has consented to future marketing communications. |
email
-
String
|
The email address of the customer. |
firstName
-
String
|
The first name of the customer. |
lastName
-
String
|
The last name of the customer. |
phone
-
String
|
The phone number of the customer. |
Example
{
"acceptsMarketing": true,
"email": "abc123",
"firstName": "abc123",
"lastName": "xyz789",
"phone": "xyz789"
}
UpdateOneCartInput
Fields
| Input Field | Description |
|---|---|
id -
ID!
|
The id of the record to update |
update
-
UpdateCartInput!
|
The update to apply. |
Example
{"id": 4, "update": UpdateCartInput}
Venue
Description
A venue is the location a session will take place at.
Fields
| Field Name | Description |
|---|---|
address
-
String
|
The street address of the venue. |
city -
String!
|
The venue's city. |
country
-
String!
|
The venue's country. |
id -
ID!
|
The ID of the venue. |
latLong
-
String
|
The latitude and longitude of the venue. |
name -
String!
|
The name of the venue. |
postalCode
-
String
|
The venue's zip or postcode. |
space
-
String
|
The room, hall or building within the venue. |
state
-
String
|
The venue's state. |
suburb
-
String
|
The suburb of the venue. |
timezone
-
String!
|
The timezone of the venue. |
Example
{
"address": "xyz789",
"city": "abc123",
"country": "abc123",
"id": "4",
"latLong": "xyz789",
"name": "xyz789",
"postalCode": "xyz789",
"space": "xyz789",
"state": "xyz789",
"suburb": "xyz789",
"timezone": "abc123"
}
VenueConnection
Fields
| Field Name | Description |
|---|---|
edges
-
[VenueEdge!]!
|
Array of edges. |
pageInfo
-
PageInfo!
|
Paging information |
Example
{
"edges": [VenueEdge],
"pageInfo": PageInfo
}
VenueEdge
Fields
| Field Name | Description |
|---|---|
cursor
-
ConnectionCursor!
|
Cursor for this node. |
node -
Venue!
|
The node containing the Venue |
Example
{
"cursor": ConnectionCursor,
"node": Venue
}
VenueFilter
Fields
| Input Field | Description |
|---|---|
and -
[VenueFilter!]
|
|
city -
StringFieldComparison
|
|
country
-
StringFieldComparison
|
|
id -
IDFilterComparison
|
|
name -
StringFieldComparison
|
|
or -
[VenueFilter!]
|
|
space
-
StringFieldComparison
|
Example
{
"and": [VenueFilter],
"city": StringFieldComparison,
"country": StringFieldComparison,
"id": IDFilterComparison,
"name": StringFieldComparison,
"or": [VenueFilter],
"space": StringFieldComparison
}
VenueSort
Fields
| Input Field | Description |
|---|---|
direction
-
SortDirection!
|
|
field
-
VenueSortFields!
|
|
nulls
-
SortNulls
|
Example
{"direction": "ASC", "field": "city", "nulls": "NULLS_FIRST"}
VenueSortFields
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"city"