Follow

API Method - Item Get

This method will get the details about a single item for sale
Parameters
appKey
 
string
A key identifying the application making the call
userKey
 
string
A key identifying the user making the call
corpOrgID
 
int
The corp organization ID
type
 
int
The type of items to list (1 – Event, 2 – Product, 9 – Membership, 11 – Donation, 12 – Gift Card)
itemID
 
long
 
The ID of the item
buyerTypeID
 
int
 
The buyer type ID
Return Values
An item data structure with the following fields
ID
 
long
The item ID
Name
 
string
Name of the item
Internal Name
 
string
Internal Name of the item
Type
 
int
The type of the item (1 – Event, 2 – Product, 9 – Membership, 11 – Donation, 12 – Gift Card, 100 - Shows)
CorpOrgID
 
int
ID of the corp organization
CorpOrgName
 
string
Name of the corp organization
FolderID
 
int
ID of the folder containing the item
Description
 
string
The description of the item
ShortDescription
 
string
The short description of the item
ShortDescriptive1
 
string
The supporting text for an item name
ShortDescriptive2
 
string
The supporting text for an event date/time
ExtraHTML
 
string
The extra HTML/Text for the item
PurchasePrompt
 
string
Text to prompt customer for purchase
MoreInfoPrompt
 
string
Text for user to click for additional information
SalesState
 
int
The current sales status (1 – Before sales, 2 – Available for sales, 3 – After sales but before the event, 4 – After event, 5 – Display custom message)
SalesMessage
 
string
The current sales message to display
HTMLDisplayColor
 
string
Color for an item
ExternalID
 
string
(Event Only) External ID for the event
StartDateTime
 
YYYY-MM-DDThh:mm:ss string (ISO 8601)
(Event Only) The start date/time of the event formatted as YYYY-MM-DDThh:mm:ss
EndDateTime
 
YYYY-MM-DDThh:mm:ss string (ISO 8601)
(Event Only) The end date/time of the event formatted as YYYY-MM-DDThh:mm:ss
Duration
 
int
(Event Only) The duration in minutes of the event
DateTBD
 
bool
(Event Only) The date/time of the event is still to be determined
DisplayTime
 
bool
(Event Only) The time should be shown when displaying the event
DisplayEndDate
 
bool
(Event Only) The end date should be shown when displaying the event
VenueID
 
int
(Event Only) The venue ID
VenueName
 
string
(Event Only) The name of the venue
GroupID
 
int
(Catalog Only) ID of the catalog group
GroupName
 
string
(Catalog Only) Name of the catalog group
PledgeThreshold
 
int
(Donation Only) Minimum required to donate to be able to pledge
AllowOpenEntry
 
bool
(Donation / Gift Card Only) The customer should be allowed to input custom value
Media
 
list
A list of additional images, html, or trailers for the show
Caption
 
string
The caption to show with the media or image
MainDuplicate
 
bool
Indicates this is the same as the main image
Sequence
 
int
The sequence order for sorting
Type
 
string
The type of media (Image, HTML, YouTube, Vimeo)
Value
 
string
The raw URL or html value
MediaEmbed
 
string
The formatted html for embed
CustomProperties
 
list
A list of custom property data structures with the following fields
ID
 
int
The custom property ID
Group
 
string
The grouping value for the custom property
Name
 
string
The custom property name
Value
 
string
The custom value for this show
Hidden
 
bool
Indicates whether this custom property should be visible to the end customer or just internal
Sequence
 
int
The sequence order for sorting
RelatedItems
 
list
A list of related events or shorts
ID
 
long
The related event ID
OrgID
 
int
The event level organization ID
Name
 
string
The name of the event
UntilDate
 
datetime
The date of the related event
Duration
 
int
The duration of the event in minutes
ShortDescriptive
 
string
The supporting text for the event name
Description
 
string
The description of the event
ImageURL
 
string
The image URL
ThumbnailURL
 
string
The thumbnail image URL
Errors
ApplicationKeyMissing
 
1000
Required parameter appkey is missing or invalid
UserCredentialsMissing
 
1001
Required user credentials are missing or invalid
SecurityInsufficient
 
1002
User security does not permit access to the requested function
RequiredParameter
 
1028
Required parameter is missing
Example Request
https://prod1.agileticketing.net/api/sales.svc/xml/ItemGet?appkey={APPKEY}&userkey={USERKEY}&corporgid={CORPORGID}&type={ITEMTYPE}&itemid={ITEMID}&buyertypeid={BUYERTYPEID}&
Example JSON Response
{
	"ID":9223372036854775807,
	"Name":"String content",
	"InternalName":"String content",
	"Type":1,
	"CorpOrgID":2147483647,
	"CorpOrgName":"String content",
	"FolderID":2147483647,
	"Description":"String content",
	"ShortDescription":"String content",
	"ShortDescriptive1":"String content",
	"ShortDescriptive2":"String content",
	"ExtraHTML":"String content",
	"PurchasePrompt":"String content",
	"MoreInfoPrompt":"String content",
	"SalesState":"2",
	"SalesMessage":"String content",
	"HTMLDisplayColor":"FFFFFF",
	"ExternalID":"String content",
	"StartDateTime":"YYYY-MM-DDThh:mm:ss",
	"EndDateTime":"YYYY-MM-DDThh:mm:ss",
	"Duration":2147483647,
	"DateTBD":true,
	"DisplayTime":true,
	"DisplayEndDate":true,
	"VenueID":2147483647,
	"VenueName":"String content",
	"GroupID":2147483647,
	"GroupName":"String content",
	"PledgeThreshold":2147483647,
	"AllowOpenEntry":true,
	"Media":[{
		"Caption":"String content",
		"MainDuplicate":true,
		"Sequence":2147483647,
		"Type":"String content",
		"Value":"String content",
		"MediaEmbed":"String content"
	}],
	"CustomProperties":[{
		"ID":2147483647,
		"Group":"String content",
		"Name":"String content",
		"Value":"String content",
		"Hidden":true,
		"Sequence":2147483647
	}],
	"RelatedItems":[{
		"ID":9223372036854775807,
		"OrgID":2147483647,
		"Name":"String content",
		"UntilDate":"\/Date(928167600000-0500)\/",
		"Duration":2147483647,
		"ShortDescriptive":"String content",
		"Description":"String content",
		"ImageURL":"String content",
		"ThumbnailURL":"String content"
	}]
}
Example XML Response
<SalesItem xmlns="http://www.agiletix.com/api">
  <ID>9223372036854775807</ID>
  <Name>String content</Name>
  <InternalName>String content</InternalName>
  <Type>1</Type>
  <CorpOrgID>2147483647</CorpOrgID>
  <CorpOrgName>String content</CorpOrgName>
  <FolderID>2147483647</FolderID>
  <Description>String content</Description>
  <ShortDescription>String content</ShortDescription>
  <ShortDescriptive1>String content</ShortDescriptive1>
  <ShortDescriptive2>String content</ShortDescriptive2>
  <ExtraHTML>String content</ExtraHTML>
  <PurchasePrompt>String content</PurchasePrompt>
  <MoreInfoPrompt>String content</MoreInfoPrompt>
  <SalesState>2147483647</SalesState>
  <SalesMessage>String content</SalesMessage>
  <HTMLDisplayColor>FFFFFF</HTMLDisplayColor>
  <ExternalID>String content</ExternalID>
  <StartDate>YYYY-MM-DDThh:mm:ss</StartDate>
  <EndDate>YYYY-MM-DDThh:mm:ss</EndDate>
  <Duration>2147483647</Duration>
  <DateTBD>true</DateTBD>
  <DisplayTime>true</DisplayTime>
  <DisplayEndDate>true</DisplayEndDate>
  <VenueID>2147483647</VenueID>
  <VenueName>String content</VenueName>
  <GroupID>2147483647</GroupID>
  <GroupName>String content</GroupName>
  <PledgeThreshold>2147483647</PledgeThreshold>
  <AllowOpenEntry>true</AllowOpenEntry>
  <Media>
    <AdditionalMediaItem>
      <Caption>String content</Caption>
      <MainDuplicate>true</MainDuplicate>
      <MainThumb>false</MainThumb>
      <Sequence>2147483647</Sequence>
      <Type>String content</Type>
      <Value>String content</Value>
      <MediaEmbed>String content</MediaEmbed>
    </AdditionalMediaItem>
  </Media>
  <CustomProperties>
    <CustomItemProperty>
      <ID>2147483647</ID>
      <Group>String content</Group>
      <Name>String content</Name>
      <Value>String content</Value>
      <Hidden>true</Hidden>
      <Sequence>2147483647</Sequence>
    </CustomItemProperty>
  </CustomProperties>
  <AdditionalMedia>
    <AdditionalMediaItem>
      <Caption>String content</Caption>
      <MainDuplicate>true</MainDuplicate>
      <Sequence>2147483647</Sequence>
      <Type>String content</Type>
      <Value>String content</Value>
      <MediaEmbed>String content</MediaEmbed>
    </AdditionalMediaItem>
  </AdditionalMedia>
  <RelatedItems>
    <RelatedEvent>
      <ID>9223372036854775807</ID>
      <OrgID>2147483647</OrgID>
      <Name>String content</Name>
      <UntilDate>1999-05-31T11:20:00</UntilDate>
      <Duration>2147483647</Duration>
      <ShortDescriptive>String content</ShortDescriptive>
      <Description>String content</Description>
      <ImageURL>String content</ImageURL>
      <ThumbnailURL>String content</ThumbnailURL>
    </RelatedEvent>
  </RelatedItems>
</SalesItem>
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments