SPORTS EVENTS AND EXPERIENTIAL TRAVEL PACKAGES
Menu
中文(简体) Spanish (español) English (UK)
Login Track Order (0)
Choose Currency

API Tools

Get your P-Authorization

Implementation of API requires some initial settings to be done. These setting are done by Pulse Experiential Travel. Below is detail about “what you need to do for using our API”?

  1. Register yourself as reseller with Pulse Experiential Travel.
  2. Provide required details to Pulse Experiential Travel and for productions don’t forget to whitelist your IP’s.
  3. Every request has either POST or GET verb. POST request must be in JSON format.
  4. To do your first request you need ‘Security Token’ and ‘Reseller id’.
  5. With above details you also need an “encryption key” which will be used to generate EncryptedAuthKey. This EncryptedAuthKey will be sent as value of header parameter ‘P-Authorization’. (Valid for a 24 hours)
  6. To use production API update Pulse Experiential Travel to enable you for this. There is special process to create your ‘P-Authorization’. Logic is below (Lang. PHP):
$currentTimestamp format [UTC]: 2016-08-29 01:28:37
$signature = $currentTimestamp . $key;
EncryptedAuthKey= base64_encode( hash ( "SHA256" , $signature) );

Get Your Key to generate AuthKey. For testing this can be manually generated here:

Link: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=reseller

Below we have explained both the categories of API’s. Each category has a set of sequence to be followed to get data and make a final purchase notification to Pulse Experiential Travel.

For Travel Packages please go through the below serial order by which API is listed and explained.

To Purchases Tickets there are some basic rules and sequence that is needed to be followed strictly to make a final purchase notification to Pulse Experiential Travel. Below is the sequence:

  1. Select a production from production list using the event or venue.
  2. Then fetch inventories form the selected production.
  3. Allow user to select an inventory. Then get all details of that selected inventory.
  4. Depending on quantity get all ticket price. e.g. (ticket price * quantity selected)
  5. Fetch the shipping method ids for the Ticket id of the selected inventory.
  6. Add the price of shipping method selected to tickets price.
  7. Fetch service charges of selected ticket and add it to the sum of ticket price and shipping price. Finally make purchase request with all the parameter in JSON format.
1. To get main category for products (Task = vmcategories)

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=vmcategories&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=vmcategories&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json'
]

GET Request with following parameters in URL

[
start - (Page starts From),
size - (Page size)
]

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
2. To get sub category for main category (Task = vmsubcategories)

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=vmsubcategories&mcatid=MAINCAT_ID&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=vmsubcategories&mcatid=MAINCAT_ID&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json'
]

GET Request with following parameters in URL

[
mcatid - (Main Category Id is passed in this parameter can be retrieved from the "Main category for Products API"),
start - (Page starts From),
size - (Page size)
]

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
3. To get products of a particular sub category (Task = vmproducts)

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=vmproducts&catid=CATEGORY_ID&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=vmproducts&catid=CATEGORY_ID&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json'
]

GET Request with following parameters in URL

[
catid - (Sub Category Id is passed as parameter),
start - (Page starts From),
size - (Page size)
]

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
4. To get detail of a single product (Task = vmsingle_product)

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=vmsingle_product&id=PRODUCT_ID&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=vmsingle_product&id=PRODUCT_ID&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
]

GET Request with following parameters in URL

[
id - (This parameter accepts Product Id of the product for which details is needed),
]

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
5. Send buy notification of product (Task = purchase_done)

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=purchase_done&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=purchase_done&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
P-Authorization: 'EncryptedAuthKey',
P-TimeStamp: 'CurrentTimeStamp'
]

POST Request for the Orders Purchased

{
"orderId":"432e32",
   "productDetail":[  
      {  
         "productSku":"SAMER27",
         "productQty":"1",
         "productPrice":"22",
         "orderRewardId" : "kllklk"
      },
      {  
         "productSku":"SAMER27",
         "productQty":"1",
         "productPrice":"22",
         "orderRewardId" : "56hr6"
      },
	{  
         "productSku":"SAMER27",
         "productQty":"1",
         "productPrice":"22",
         "orderRewardId" : "345erlk"
      },
      {  
         "productSku":"YELLO27",
         "productQty":"1",
         "productPrice":"213",
         "orderRewardId" : "5kf0"
      }   
    ],
   "userEmail":"john@email.com",
   "userFirstName":"John",
   "userLastName":"Doe",
   "userAddressOne":"Address1",
   "userAddressTwo":"Address2",
   "userCity":"City",
   "userRegion":"Region",
   "userCountry":"Country",
   "userZip":"Zip",
   "userPhone":"Phone",
   "type":"Travel Packages"
}
                    

Response for the Orders Purchased

{
  "Succeeded": true,
  "StatusCode": "30",
  "StatusMessage": "The operation completed successfully",
  "OrderDetail": {
    "error": 0,
    "msg": "Orders Sent Successfully",
    "orderId": "PULSE930481",
    "partnerCode":"PET001",
    "purchaseData": [
      {
        "productSku": "SAMER27",
        "productQty": "1",
        "orderRewardId": "kllklk",
        "CertificateNumber": "SAMER27-CART-060217-V44",
        "CertificateRedemptionForm": "[URL]/SAMER27-CART-060217-V44.pdf",
      },
      {
        "productSku": "SAMER27",
        "productQty": "1",
        "orderRewardId": "56hr6",
        "CertificateNumber": "SAMER27-CART-060217-P53"
        "CertificateRedemptionForm": "[URL]/SAMER27-CART-060217-P53.pdf",
      },
      {
        "productSku": "SAMER27",
        "productQty": "1",
        "orderRewardId": "345erlk",
        "CertificateNumber": "SAMER27-CART-060217-S71",
        "CertificateRedemptionForm": "[URL]/SAMER27-CART-060217-S71.pdf",
      },
      {
        "productSku": "YELLO27",
        "productQty": "1",
        "orderRewardId": "5kf0",
        "CertificateNumber": "YELLO27-CART-060217-CK6",
        "CertificateRedemptionForm": "[URL]/YELLO27-CART-060217-CK6.pdf",
      }
    ]
  }
}
                    

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
40 Value Missing Header or parameter is missing
1. To GET Productions List (Task = productions )

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=productions&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=productions&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
]

GET Method with parameter's

[
startDate: This parameter is used to filter response by Event's start date,
endDate: This parameter is used to filter response by Event's end date,
searchKey: This parameter is used to filter response by Event's venue or name keyword,
productionId: This parameter accepts production id and return all details related to that,
sortBy: This parameter accepts 0 or 1. For ascending use 0 and for descending use 1,
sortOrder: This parameter accepts value for the field according to which sorting is to be done,
pageNumber: This parameter accepts Page number to be displayed,
pageSize: This parameter accepts page size to be displayed,
]

Get Request response

{
    "Status": {
        "Code": 0,
        "Message": "The operation completed successfully.",
        "Succeeded": true
    },
    "Productions": [
        {
            "CT_EventDate": "/Date(1498154400000-0500)/",
            "City": "Chicago",
            "EventDate": "/Date(1498154400000-0500)/",
            "EventID": 36311,
            "EventName": "Tim Meadows",
            "EventTypeID": 4,
            "IsBarcodeRequired": false,
            "IsDigitalDelivery": false,
            "IsLiveOnTMPlus": false,
            "IsManifestAvailable": false,
            "IsMobileDeliveryOnly": false,
            "IsTBADate": false,
            "IsTBATime": false,
            "IsTicketFastProduction": false,
            "MyBarcodedSeatCount": 0,
            "MyListingsCount": 0,
            "MySeatCount": 0,
            "OpponentEventID": 0,
            "OpponentEventName": "",
            "ProductionID": 10193116,
            "ProductionName": "Tim Meadows",
            "ProductionStatus": 1,
            "SeatingChartUrl": "",
            "ShortNote": "",
            "State": "IL",
            "TM_Event_ID": "",
            "VenueID": 5246,
            "VenueName": "Union Park"
        }
    ]
}
                    

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
2. To GET inventory details (Task = inventory)

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=inventory&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=inventory&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
]

GET Method with parameter's

[
eventProductionid: This parameter accepts the Product Id for which inventories are needed,
ticketId: This parameter accepts the Ticket ID for which details are needed. [This must be passed to get the Quantity array of particular ticket ],
]

Get Request response

{
    "Status": {
        "Code": 0,
        "Message": "The operation completed successfully.",
        "Succeeded": true
    },
    "Inventories": [
        {
            "Barcodes": null,
            "BrokerID": null,
            "BrokerName": "Private",
            "Cost": "55.00",
            "CurrencyCode": "USD",
            "DateAdd": "/Date(1489096215493-0600)/",
            "Description": "REM TEST",
            "DigitalDelayOffsetMinutes": null,
            "DigitalDeliveryDate": null,
            "EndSeat": "40",
            "EventDate": "/Date(1498392000000-0500)/",
            "EventName": "Toyota Save Mart 350",
            "EventTime": "07:00 AM",
            "ExchangeRate": 1,
            "Face": 0,
            "InHandDate": null,
            "InventoryStatus": 1,
            "InventoryTypeId": 1,
            "IsAllowSplit": true,
            "IsB2BDisplayProtectionEnabled": false,
            "IsBarcodesLocked": false,
            "IsConsignment": false,
            "IsCurrencyConversionApplied": false,
            "IsEligibleForB2B": true,
            "IsInstantDelivery": false,
            "IsOutOnConsignment": false,
            "IsPDFAvailable": false,
            "IsSpeculation": false,
            "IsTMPlusDisplayProtectionEnabled": false,
            "IsTMRDisplayProtectionEnabled": false,
            "List": 0,
            "ManifestFailureCondition": null,
            "ManifestFailureConditionTypeID": 0,
            "POSInventoryStatus": null,
            "ProductionID": 10190930,
            "Quantity": 40,
            "QuantitySold": 0,
            "QuantitySplitOptions": [],
            "Row": "A",
            "Section": "110A",
            "ShareTypeId": null,
            "StartSeat": "1",
            "Status": {
                "Code": 0,
                "Message": "",
                "Succeeded": true
            },
            "SupplierTicketID": null,
            "TicketID": 295207972,
            "TicketSourceID": 11,
            "VenueName": "Sonoma Raceway"
        }
    ]
}
                    

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
3. To GET shipping method (Task = shipping)

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=shipping&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=shipping&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
]

GET Method with parameter's

[
ticketId: Ticket Id for which shipping details is required ,
]

Get Request response

{
    "Status": {
        "Code": 0,
        "Message": "The operation completed successfully.",
        "Succeeded": true
    },
    "ShippingMethods": [
        {
            "B2BCost": 0,
            "IsElectronic": true,
            "Name": "Ticketmaster® Verified - Electronic Delivery",
            "ShippingMethodId": 14
        }
    ]
}
                    

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
4. To GET service charge details (Task = servicecharge )

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=servicecharge&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=servicecharge&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
]

GET Method with parameter's

[
ticketId: Ticket Id for which shipping details is required ,
quantity: This parameter accepts quantity of tickets to be purchased.
]

Get Request response

{
    "Status": {
        "Code": 0,
        "Message": "The operation completed successfully.",
        "Succeeded": true
    },
    "ServiceChargeAmount": 0
}
                    

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
5. To get countries details (Task = countries )

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=countries&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=countries&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
]

Get Request response

{
    "Status": {
        "Code": 0,
        "Message": "The operation completed successfully.",
        "Succeeded": true
    },
    "Countries": [
        {
            "CountryCode": "US",
            "CountryID": 1,
            "CountryName": "United States"
        }
    ]
}
                    

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
6. To GET regions details (Task = regions )

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=regions&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=regions&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
]

GET Method with parameter's

[
countryID: country Id for which details is required ,
]

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid
7. Buy a ticket (Task = purchase_request )

Test URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=testresellerapi&task=purchase_request&resellerid=YOUR_RESELLER_ID

Live URL: https://www.pulseexperientialtravel.com/index.php?option=com_virtuemart&view=resellerapi&task=purchase_request&resellerid=YOUR_RESELLER_ID

GET Request with following parameters in header

[
SecurityToken:'XXXXXXXXXXXXXX',
Content-Type: ‘application/json',
Accept: 'application/json',
P-Authorization: 'EncryptedAuthKey',
P-TimeStamp: 'CurrentTimeStamp'
]

GET Method with parameter's

[
ticketId: Ticket Id for which shipping details is required ,
quantity: This parameter accepts quantity of tickets to be purchased.
]

POST Request for the Orders

{
    "orderId": 24002500,
    "quantity": 2,
    "ticketId": 293300890,
    "ShippingMethodID": 21,
    "ticketPrice":"128.70",
    "userEmail":john@email.com,
    "userFirstName":"John",
    "userLastName ":"Doe",
    "userAddressOne":"Address1",
    "userAddressTwo":"Address2",
    "userCity":"City"
    "userRegion":"Region"
    "userCountry":"Country"
    "userZip":"Zip"
    "userPhone:"Phone"
}
                    

Response for the Orders Purchased

{
    "Succeeded": true,
    "StatusCode": "0",
    "StatusMessage": "The operation completed successfully",
    "OrderDetail": {
        "PulseOrderID": "PULSE645638"
    }
}
                    

Response Codes:

Value Name Description
30 Success Process completed and result received
31 Failed Process not completed successfully.
34 Restricted Access Data is not Accessible. Either security token or Reseller Id is Incorrect
35 Data not available Main categories are not available or deleted
45 Invalid input Content-Type not valid
46 Value Missing Security Token is missing
47 Value Missing Reseller ID is missing
70 Invalid Method Request Method not valid