Spektrix API Help Page

Introduction

The Spektrix API can be used in three different modes:

By clicking on the links above, you can restrict the visible documentation to those appropriate to the application you are developing. Alternatively you can view All Methods

Documentation

For documentation and guidance on using our API, please visit the Integration Portal.

Clicking on the name of each resource below will give details on each request, available parameters, body examples and associated responses.

Addresses

API	Description
GET v3/addresses/{postcodeLookupId}	Returns the full address for a given ID
GET v3/addresses?postcode={postcode}	Returns a list of addresses matching a given postcode. (UK Addresses only)

AgentCredit

API	Description
GET v3/credit	Allows an agent to determine how much of their credit limit has been used, and how much remains.

Bands

API	Description
GET v3/bands	Returns a list of price bands in the system

Baskets

API	Description
POST v3/baskets	Creates a new basket
PATCH v3/baskets/{id}	To add additional information to a basket, such as a Customer, Promocode, Attributes and Delivery Methods
POST v3/baskets/{id}/clear	Clear the contents of a basket
POST v3/baskets/{id}/confirm	Confirms an order. For system-owners, this can only be used for zero-value orders. Otherwise use . For agents, this should be used for all orders
GET v3/baskets/{id}	Return the details of a basket
GET v3/baskets/{id}/potentialDiscount?membershipId={membershipId}	Returns pricing information about the current basket with the specified Membership added, without persisting the changes. This allows for the calculation of upsell information.
GET v3/baskets/{id}/donations-to-prompt	Return the suggested donations of a basket contents for the added customer record
POST v3/baskets/{id}/donations	Add donation(s) to a basket
GET v3/baskets/{id}/donations/{donationId}	Return details of the donations in a basket
GET v3/baskets/{id}/donations	Return details of the donations in a basket
PATCH v3/baskets/{id}/donations/{donationId}	Update the details of a specific donation in a basket
PATCH v3/baskets/{id}/donations	Update the details of a number of donations in a basket
DELETE v3/baskets/{id}/donations/{donationId}	Remove a specific donation from a basket
DELETE v3/baskets/{id}/donations	Remove a number of donations from a basket
GET v3/baskets/{id}/gift-vouchers	Return all gift vouchers in a basket
GET v3/baskets/{id}/gift-vouchers/{giftVoucherId}	Return the details of a specific gift voucher in a basket
POST v3/baskets/{id}/gift-vouchers	Add a gift voucher(s) to a basket
PATCH v3/baskets/{id}/gift-vouchers/{giftVoucherId}	Update the details of a specific gift voucher in a basket
PATCH v3/baskets/{id}/gift-vouchers	Update the details of a number of gift vouchers in a basket
DELETE v3/baskets/{id}/gift-vouchers	Remove a number of gift vouchers from a basket
DELETE v3/baskets/{id}/gift-vouchers/{giftVoucherId}	Remove a specific gift voucher from a basket
PUT v3/baskets/{id}/gift-vouchers	Replace all gift vouchers in a basket
GET v3/baskets/{id}/membership-subscriptions	Return the details of all memberships in a basket
GET v3/baskets/{id}/membership-subscriptions/{subscriptionId}	Return the details of a specific membership in a basket
POST v3/baskets/{id}/membership-subscriptions	Add a number of memberships to a basket
PATCH v3/baskets/{id}/membership-subscriptions/{subscriptionId}	Amend the details of a specific membership in a basket
PATCH v3/baskets/{id}/membership-subscriptions	Amend the details of a number of memberships in a basket
PUT v3/baskets/{id}/membership-subscriptions	Replace all memberships in a basket
DELETE v3/baskets/{id}/membership-subscriptions/{subscriptionId}	Remove a specific membership from a basket
DELETE v3/baskets/{id}/membership-subscriptions	Remove a number of memberships from a basket
GET v3/baskets/{id}/merchandise	No documentation available.
POST v3/baskets/{id}/merchandise	No documentation available.
PATCH v3/baskets/{id}/merchandise/{merchandiseItemId}	No documentation available.
PATCH v3/baskets/{id}/merchandise	No documentation available.
DELETE v3/baskets/{id}/merchandise/{merchandiseItemId}	Remove a specific merchandise item from a basket
DELETE v3/baskets/{id}/merchandise	Remove a number of merchandise items from a basket
PUT v3/baskets/{id}/merchandise	Replace all merchandise items in a basket
GET v3/baskets/{id}/tickets	Return details of the tickets in a basket
GET v3/baskets/{id}/tickets/{ticketId}	Return the details of a specific ticket in a basket
POST v3/baskets/{id}/tickets	Add a ticket(s) to a basket
POST v3/baskets/{id}/tickets/best-available	Add some best-available tickets from a reserved seating plan to a basket
PATCH v3/baskets/{id}/tickets/{ticketId}	Update the detail of a specific ticket in a basket
PATCH v3/baskets/{id}/tickets	Update the details of a number of tickets in a basket
DELETE v3/baskets/{id}/tickets/{ticketId}	Delete a specific ticket from a basket
DELETE v3/baskets/{id}/tickets	Remove specific tickets from a basket
PUT v3/baskets/{id}/tickets	Replace all the tickets in a basket
POST v3/baskets/{id}/ticket-subscriptions	Add a number of ticket subscriptions to a basket
GET v3/baskets/{id}/ticket-subscriptions	Return all ticket subscriptions in a basket
GET v3/baskets/{id}/ticket-subscriptions/{ticketSubscriptionId}	Return the specified ticket subscription in a basket
DELETE v3/baskets/{id}/ticket-subscriptions/{ticketSubscriptionId}	Remove a specific ticket subscription from a basket
DELETE v3/baskets/{id}/ticket-subscriptions	Remove multiple ticket subscriptions from a basket

Countries

API	Description
GET v3/countries	Return a list of countries
GET v3/countries/{isoCode}	Return a specific country

Events

API	Description
GET v3/events?instanceStart_from={instanceStart_from}&instanceStart_to={instanceStart_to}&instanceInterface={instanceInterface}&onSale={onSale}&name={name}	Returns details of specific events in the system
GET v3/events/{id}	Returns the details of a specific event
GET v3/events/{id}/instances?start_from={start_from}&start_to={start_to}&interface={interface}	Returns a list of instances for a specific event

Funds

API	Description
GET v3/funds	Returns a list of available funds that can be donated too

Instances

API	Description
GET v3/instances?startFrom={startFrom}&startTo={startTo}&interface={interface}&eventName={eventName}	Returns a list of specific instances
GET v3/instances/{id}	Returns the details of a specific instance
GET v3/instances/{id}/plan	Returns the current plan information for an instance
GET v3/instances/{id}/status?includeLockInformation={includeLockInformation}&includeChildPlans={includeChildPlans}	Returns an overview of the current availability status for an instance
GET v3/instances/{id}/status/detail?includeLockInformation={includeLockInformation}&includeChildPlans={includeChildPlans}	Returns a detailed view of the availability of each seat for an instance. See here for a description of the response format.
GET v3/instances/{id}/status/areas/{areaId}/detail?includeLockInformation={includeLockInformation}&includeChildPlans={includeChildPlans}	Returns a detailed view of the availability of each seat for a specific area for an instance. See here for a description of the response format.
GET v3/instances/{id}/status/areas/{areaId}?includeLockInformation={includeLockInformation}&includeChildPlans={includeChildPlans}	Returns an overview of the current availability status of a specific area for an instance
GET v3/instances/{id}/status/areas?includeLockInformation={includeLockInformation}&includeChildPlans={includeChildPlans}	Returns an overview of the current availability status of a number of specific areas for an instance
GET v3/instances/{id}/best-available?quantity={quantity}	Returns the current best available seats for an instance for the number specified
GET v3/instances/{id}/price-list	Returns the current price list in use for an instance

Offers

API	Description
GET v3/offers?instanceStart_from={instanceStart_from}&instanceStart_to={instanceStart_to}&eventName={eventName}&promoCode={promoCode}	Return a list of available offers

Plans

API	Description
GET v3/plans/{id}	Returns a specific seating plan
GET v3/plans	Returns a list of seating plans and seat information for each

PrintAtHomeDocuments

API	Description
GET v3/print-at-home-documents/{id}	Returns a specific e-ticket from the current user

QueueStatus

API	Description
GET queue-status/{eventId}	No documentation available.

StockItem

API	Description
GET v3/stock-items	Returns a list of Merchandise items

SupportedBarcodeEncodings

API	Description
GET v3/supported-barcode-encodings	Returns a list of supported barcode types

TicketSubscriptionStructures

API	Description
GET v3/ticket-subscription-structures	Return a list of ticket subscriptions that can be purchased

TicketTypes

API	Description
GET v3/ticket-types	Returns a list of ticket types

TributeTypes

API	Description
GET v3/tribute-types	Returns a list of tribute types to be used when adding a donation

Venues

API	Description
GET v3/venues	Returns a list of Venues
GET v3/venues/{id}	Returns a specific Venue using a Venue id