Page Comparison

...

Tip
When a call takes an optional cart object, the method type will usually change from a 'get' to a 'post', and the post payload will be the cart's json. Don't forget to set the right type if you're passing in the cart.

/rest/site/stateProvinces

Method	GET	Comments
Description	returns back all states for the country provided	This is a convenience function to retrieve all configured states for a country. It just avoids having to hard code a bunch of states in an application. If you're just shipping to the US, this call doesn't make sense. However, if you ship internationally, this call can be very handy to populate a state/province field with the correct values dynamically whenever the country field changes from (example) United States to Canada.
Cookies	none
Path Parameters	none
Query Parameters	country includeCodes (boolean optional)	'United States', 'Canada', etc. true
Headers	none
Receives Json	none
Returns Json	String Array	Example: [ "Alabama", "Alaska", "American Samoa", "Arizona", "Arkansas", "Armed Forces Africa", "Armed Forces Americas", "Armed Forces Canada", "Armed Forces Europe", "Armed Forces Middle East", "Armed Forces Pacific", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Federated States of Micronesia", "Florida", "Georgia", "Guam", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Marshall Islands", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Northern Mariana Islands", "Ohio", "Oklahoma", "Oregon", "Palau", "Pennsylvania", "Puerto Rico", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virgin Islands", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] Example for include codes: [{"province":"Alabama","code":"AL"},{"province":"Alaska","code":"AK"},{"province":"American Samoa","code":"AS"}, {"province":"Arizona","code":"AZ"},{"province":"Arkansas","code":"AR"},{"province":"Armed Forces Africa","code":"AE"}, {"province":"Armed Forces Americas","code":"AA"},{"province":"Armed Forces Canada","code":"AE"}, {"province":"Armed Forces Europe","code":"AE"},{"province":"Armed Forces Middle East","code":"AE"}, {"province":"Armed Forces Pacific","code":"AP"},{"province":"California","code":"CA"},{"province":"Colorado","code":"CO"}, {"province":"Connecticut","code":"CT"},{"province":"Delaware","code":"DE"},{"province":"District of Columbia","code":"DC"}, {"province":"Federated States of Micronesia","code":"FM"},{"province":"Florida","code":"FL"}, {"province":"Georgia","code":"GA"},{"province":"Guam","code":"GU"},{"province":"Hawaii","code":"HI"}, {"province":"Idaho","code":"ID"},{"province":"Illinois","code":"IL"},{"province":"Indiana","code":"IN"}, {"province":"Iowa","code":"IA"},{"province":"Kansas","code":"KS"},{"province":"Kentucky","code":"KY"}, {"province":"Louisiana","code":"LA"},{"province":"Maine","code":"ME"},{"province":"Marshall Islands","code":"MH"}, {"province":"Maryland","code":"MD"},{"province":"Massachusetts","code":"MA"},{"province":"Michigan","code":"MI"}, {"province":"Minnesota","code":"MN"},{"province":"Mississippi","code":"MS"},{"province":"Missouri","code":"MO"}, {"province":"Montana","code":"MT"},{"province":"Nebraska","code":"NE"},{"province":"Nevada","code":"NV"}, {"province":"New Hampshire","code":"NH"},{"province":"New Jersey","code":"NJ"},{"province":"New Mexico","code":"NM"}, {"province":"New York","code":"NY"},{"province":"North Carolina","code":"NC"},{"province":"North Dakota","code":"ND"}, {"province":"Northern Mariana Islands","code":"MP"},{"province":"Ohio","code":"OH"},{"province":"Oklahoma","code":"OK"}, {"province":"Oregon","code":"OR"},{"province":"Palau","code":"PW"},{"province":"Pennsylvania","code":"PA"}, {"province":"Puerto Rico","code":"PR"},{"province":"Rhode Island","code":"RI"},{"province":"South Carolina","code":"SC"}, {"province":"South Dakota","code":"SD"},{"province":"Tennessee","code":"TN"},{"province":"Texas","code":"TX"}, {"province":"Utah","code":"UT"},{"province":"Vermont","code":"VT"},{"province":"Virgin Islands","code":"VI"}, {"province":"Virginia","code":"VA"},{"province":"Washington","code":"WA"},{"province":"West Virginia","code":"WV"}, {"province":"Wisconsin","code":"WI"},{"province":"Wyoming","code":"WY"}]

Code Block

language	javascript
theme	DJango
linenumbers	true

  function stateProvinces() {
    var country = jQuery('#stateProvincesCountry').val() || 'United States';
    jQuery.ajax({
      url: '/rest/site/stateProvinces',
      data: {country: country},
      type: 'get',
      headers: {'X-UC-Merchant-Id': 'DEMO',
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'json'
    }).done(function (states) {
          jQuery('#stateProvincesResult').html('<pre>' + JSON.stringify(states, null, '  ') + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#stateProvincesButton').on('click', stateProvinces);
  });

Code Block

language	html/xml
theme	DJango
linenumbers	true

<div class='demo'><a class='demo-link' name="demo14"></a>
  <h4 class='title'>Get State Provinces</h4>
  <div class='details'>
    Country: <input type="text" id="stateProvincesCountry" value="United States"/>
    <input type="button" class='demo-button' value="Get States/Provinces" id="stateProvincesButton"/>
    <script type="syntaxhighlighter" class="brush: javascript" id="demo-code-display14"></script>
    Result:
    <div class="results" id="stateProvincesResult"></div>
  </div>
</div>

/rest/site/stateProvinceCodes

Method	GET	Comments
Description	returns back all state codes for the country provided	This is just like /rest/site/stateProvinces, but it returns back codes instead of long names.
Cookies	none
Path Parameters	none
Query Parameters	country	'United States', 'Canada', etc.
Headers	none
Receives Json	none
Returns Json	String Array	Example: [ "AL", "AK", "AS", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FM", "FL", "GA", "GU", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MH", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "MP", "OH", "OK", "OR", "PW", "PA", "PR", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VI", "VA", "WA", "WV", "WI", "WY", "AE", "AA", "AE", "AE", "AE", "AP" ]

Code Block

language	javascript
theme	DJango
linenumbers	true

    function stateProvinceCodes() {
    var country = jQuery('#stateProvinceCodesCountry').val() || 'United States';
    jQuery.ajax({
      url: '/rest/site/stateProvinceCodes',
      data: {country: country},
      type: 'get',
      headers: {'X-UC-Merchant-Id': 'DEMO',
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'json'
    }).done(function (statesCodes) {
          jQuery('#stateProvinceCodesResult').html('<pre>' + JSON.stringify(statesCodes, null, '  ') + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#stateProvinceCodesButton').on('click', stateProvinceCodes);
  });

Code Block

language	html/xml
theme	DJango
linenumbers	true

<div class='demo'><a class='demo-link' name="demo15"></a>
  <h4 class='title'>Get State Province Codes</h4>
  <div class='details'>
    Country: <input type="text" id="stateProvinceCodesCountry" value="United States"/>
    <input type="button" class='demo-button' value="Get States/Provinces" id="stateProvinceCodesButton"/>
    <script type="syntaxhighlighter" class="brush: javascript" id="demo-code-display15"></script>
    Result:
    <div class="results" id="stateProvinceCodesResult"></div>
  </div>
</div>

/rest/site/storeFront/searchAutoSuggest

Method	GET	Comments
Description	returns back suggestions and result items based upon current search	This is just like /rest/site/stateProvinces, but it returns back codes instead of long names.
Cookies	none
Path Parameters	none
Query Parameters	search thumbnailSize	Users search string. Don't submit until 3 characters long. Desired thumbnail size on item results.
Headers	none
Receives Json	none
Returns Json	A complex object containing suggestions and results.	Example: { "sugestions": [{suggestion object}, {suggestion object}, ...], "results": [{item object}, {item object}, ...] }

/rest/site/unifiedAffiliateCookieScript

Method	GET	Comments
Description	returns back a url that can be used to construct a script element. When run, that script will set cookies to track affiliates across domains.	There's lot of ways to run the script. jQuery makes it easy. `jQuery.getScript(url);`
Cookies	none
Path Parameters	none
Query Parameters	secureHostName - the domain you wish to track affiliates on _mid - your Merchant ID (could also use header or cookie - see example)	www.mystorenamehere.com DEMO
Headers	none
Receives Json	none
Returns Json	This returns a text string, not Json!	Example: https://secure.ultracart.com/checkout/unifiedAffiliateCookie.jsp?merchantId=DEMO&secureHostName=www.mystorenamehere.com

Code Block

language	javascript
theme	DJango
linenumbers	true

 function unifiedAffiliateScript() {
    var merchantId = 'DEMO';
    var secureHostName = "www.mystorenamehere.com";
    jQuery.ajax({
      url: '/rest/site/unifiedAffiliateCookieScript',
      data:{secureHostName: secureHostName},
      type: 'get',
      headers: {'X-UC-Merchant-Id': merchantId, // this is one way to pass MID
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'text'  // NOTE: This returns back plain text!
    }).done(function (script) {
          jQuery('#unifiedAffiliateCookieScriptResult').html('<pre>' + script + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#unifiedAffiliateCookieScriptButton').on('click', unifiedAffiliateScript);
  });

Code Block

language	html/xml
theme	DJango
linenumbers	true

<div class='demo'><a class='demo-link' name="demo16"></a>
  <h4 class='title'>Unified Affiliate Cookie Script</h4>
  <div class='details'>
    <input type="button" class='demo-button' value="Get Script" id="unifiedAffiliateCookieScriptButton"/>
    <script type="syntaxhighlighter" class="brush: javascript" id="demo-code-display16"></script>
    Result:
    <div class="results" id="unifiedAffiliateCookieScriptResult"></div>
  </div>
</div>

...

/rest/site/advertisingSources

Method	GET	Comments
Description	returns back a string array of all advertising sources for a merchant and (optionally) a specific theme code.
Cookies	none
Path Parameters	none
Query Parameters	screenBrandingThemeCode	Theme code is optional. If not provided, the default is used (DFLT). To manage your theme codes, login to the back end (secure.ultracart.com) and navigate to Home → Configuration → Look and Feel Section → Screen Branding Themes
Headers	none
Receives Json	none
Returns Json	A string array of advertising sources	Example: [ "ABC Family", "Allure Magazine", "BBC America", "Biography Channel", "Cosmopolitan Magazine", "CW+", "Discovery Health", "Discovery Home", "DIY Channel", "E! Channel", "Elle Magazine", "Enquirer", "Essence Magazine", "First For Women Magazine", "Food Channel", "Friend/Family", "GAC", "Glamour Magazine", "Google", "HGTV", "In Style Magazine", "Internet Search Engines", "ION", "Ladies Home Journal", "Lifetime Movies Network", "Lucky Magazine", "Mailer", "Marie Claire Magazine", "Money Mailer Coupon", "MTV", "O, The Oprah Magazine", "OK magazine", "Oxygen Channel", "Quick and Simple Magazine", "Radio", "Redbook Magazine", "Self Magazine", "Shape Magazine", "Soapnet Channel", "Star Magazine", "Style Channel", "Tennis Channel", "Us Weekly Magazine", "VH1", "Vogue Magazine", "WeTV", "Woman's World Magazine", "WWD Magazine", "Yahoo!" ]

Code Block

language	javascript
theme	DJango
linenumbers	true

   function advertisingSources() {
    var themeCode = "DFLT";
    jQuery.ajax({
      url: '/rest/site/advertisingSources',
      data:{screenBrandingThemeCode: themeCode},
      type: 'get',
      headers: {'X-UC-Merchant-Id': 'SANTI', // this is one way to pass MID
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'json'
    }).done(function (sources) {
          jQuery('#advertisingResult').html('<pre>' + JSON.stringify(sources, null, '  ') + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#advertisingButton').on('click', advertisingSources);
  });

Code Block

language	html/xml
theme	DJango
linenumbers	true

<div class='demo'><a class='demo-link' name="demo17"></a>
  <h4 class='title'>Advertising Sources</h4>
  <div class='details'>
    <input type="button" class='demo-button' value="Get Advertising Sources" id="advertisingButton"/>
    <script type="syntaxhighlighter" class="brush: javascript" id="demo-code-display17"></script>
    Result:
    <div class="results" id="advertisingResult"></div>
  </div>
</div>

/rest/site/returnPolicy

Method	GET	Comments
Description	returns back a plain text string of the merchant's return policy	returns back the policy for the default theme (DFLT) unless the theme is specified Fetches a merchant's return policy. Some of you guys have massive return policies, especially anyone selling an digestible product. We don't want to carry that back and forth with every call, so we don't attach it to the cart object. It's separate. You'll probably fetch it once and store it somewhere. localStorage is a great idea...
Cookies	none
Path Parameters	none
Query Parameters	screenBrandingThemeCode	Theme code is optional. If not provided, the default is used (DFLT). To manage your theme codes, login to the back end (secure.ultracart.com) and navigate to Home → Configuration → Look and Feel Section → Screen Branding Themes
Headers	none
Receives Json	none
Returns Json	This returns a text string, not Json!	Example: I want you to love your jewelry item. If you are not completely satisfied with your purchase you may return the item within 14 days of receiving it for exchange or credit ONLY (excludes custom orders). Item must be in its' original packaging and in perfect, unused condition. Sorry, shipping costs will not be refunded.

Code Block

language	javascript
theme	DJango
linenumbers	true

function returnPolicy() {
    var themeCode = "DFLT";
    jQuery.ajax({
      url: '/rest/site/returnPolicy',
      data:{screenBrandingThemeCode: themeCode},
      type: 'get',
      headers: {'X-UC-Merchant-Id': 'DEMO', // this is one way to pass MID
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'text' // NOTICE the data type.  This returns plain text.
    }).done(function (returnPolicy) {
          jQuery('#returnPolicyResult').html('<pre>' + returnPolicy + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#returnPolicyButton').on('click', returnPolicy);
  });

...

/rest/site/allowedCountries

Method	GET	Comments
Description	returns back a string array of all countries a merchant ships to
Cookies	none
Path Parameters	none
Query Parameters	none
Headers	none
Receives Json	none
Returns Json	A string array of countries	Example: [ "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antigua", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Azores", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Barbuda", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire", "Bosnia and Herzegovina", "Botswana", "Brazil", "British Virgin Islands", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Canary Islands", "Cape Verde Islands", "Cayman Islands", "Central African Republic", "Chad", "Channel Islands", "Chile", "China", "Christmas Island", "Cocos Islands", "Colombia", "Comoros", "Congo", "Cook Islands", "Costa Rica", "Cote d'Ivoire", "Croatia", "Cuba", "Curacao", "Cyprus", "Czech Republic", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt"] ... and many more ...

Code Block

language	javascript
theme	DJango
linenumbers	true

  function allowedCountries() {
    jQuery.ajax({
      url: '/rest/site/allowedCountries',
      type: 'get',
      headers: {'X-UC-Merchant-Id': 'DEMO', // this is one way to pass MID
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'json'
    }).done(function (countries) {
          jQuery('#allowedCountriesResult').html('<pre>' + JSON.stringify(countries, null, '  ') + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#allowedCountriesButton').on('click', allowedCountries);
  });

...

rest/site/customerIpAddress

Method	GET	Comments
Description	returns back the customer's ip address
Cookies	none
Path Parameters	none
Query Parameters	none
Headers	none
Receives Json	none
Returns Json	Plain Text! IP Address	Example: 127.0.0.1

Code Block

language	javascript
theme	DJango
linenumbers	true

    function customerIpAddress() {
    jQuery.ajax({
      url: '/rest/site/customerIpAddress',
      type: 'get',
      headers: {'X-UC-Merchant-Id': 'DEMO', // this is one way to pass MID
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'text' // Note! Plain text string
    }).done(function (ipAddress) {
          jQuery('#customerIpAddressResult').html('<pre>' + ipAddress + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#customerIpAddressButton').on('click', customerIpAddress);
  });

...

/rest/site/items/search

Method GET Comments

Description

search for items, and returns back a paginated result search.

Cookies

none

Path Parameters

none

Query Parameters

search

itemsPerPage

currentPage

secureServerName

thumbnailSize

string, the search term to look for.

integer

this name is used in the url construction (see example results) so that the view urls are already pointing at your server.

optional integer: one of these values: 80, 100, 200, 220, 250, 500. This is an optional parameter. The default is 80px. Thumbnails are always square.

Headers

none

Receives Json none

Returns Json

A complex object containing pagination information

and an array of items

Example:

{
  "totalResults": 1,
  "currentPage": 1,
  "totalPages": 1,
  "items": [
    {
      "extendedDescription": "",
      "description": "BONE",
      "thumbnailUrl": "1369252924157/DEMO/8/9/80-80-89BDA673BC716255B7EC50069B4A398F.jpg",
      "cost": 20,
      "viewUrl": "http://secure.ultracart.com/catalog/DEMO/products/facebook/fb-single/Bone.html",
      "addToCartUrl": "/cgi-bin/UCEditor?merchantId=DEMO&ADD=Bone"
    }
  ]
}

Info

to use the thumbnail, append it to secure.ultracart.com/thumbs/ or the equivalent server name if your SSL is hosted with UltraCart.

The addToCartUrl should be appended to https://secure.ultracart.com (or your SSL name if hosted with UltraCart).

Code Block

language	javascript
theme	DJango
linenumbers	true

    function itemSearch() {
    var merchantId = jQuery('#itemSearchMerchantId').val() || 'DEMO';
    var search = jQuery('#itemSearchField').val() || '';
    var itemsPerPage = 5;
    var currentPage = 1;
    var secureServerName = "secure.ultracart.com";
    var data ={
      _mid:merchantId,
      search:search,
      itemsPerPage:itemsPerPage,
      currentPage:currentPage,
      secureServerName: secureServerName
    };

    jQuery.ajax({
      url: '/rest/site/items/search',
      type: 'get',
      data: data,
      headers: {// 'X-UC-Merchant-Id': 'DEMO', // PASSING IN Merchant ID as parameter so you can try your own!
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'json'
    }).done(function (results) {
          jQuery('#itemSearchResult').html('<pre>' + JSON.stringify(results, null, '  ') + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#itemSearchButton').on('click', itemSearch);
  });

Code Block

language	html/xml
theme	DJango
linenumbers	true

<div class='demo'><a class='demo-link' name="demo21"></a>
  <h4 class='title'>Item Search</h4>
  <div class='details'>

    Merchant ID: <input type="text" id="itemSearchMerchantId" value='DEMO' /><br>
    Search Term: <input type="text" id="itemSearchField" value='BONE' /><br>
    <input type="button" class='demo-button' value="Search for Items" id="itemSearchButton"/>
    <script type="syntaxhighlighter" class="brush: javascript" id="demo-code-display21"></script>
    Result:
    <div class="results" id="itemSearchResult"></div>
  </div>
</div>

/rest/site/items

Method GET Comments

Description

retrieves a list of items

if both ids and url are provided, url is used.

Cookies

none

Path Parameters

none

Query Parameters

id (array)

url

thumbnailSize

cartId

&id=item1&id=item2&id=item3

Note
If you are going to request more than one item id at a time via jQuery, make sure that you set traditional = true in your ajaxSettings.

the full url to a catalog group. this must be a valid catalog group. Example: https://secure.ultracart.com/catalog/DEMO/rest_demo/

(the url above will show an ugly page. It was created for the item data, not to serve as a fully functional page.

optional integer: one of these values: 80, 100, 200, 220, 250, 500. This is an optional parameter. The default is 80px. Thumbnails are always square.

If a cart id is passed in as a query, the associated cart is loaded and referenced. If the cart has a logged in customer (valid customer profile), then any items returned will have their pricing applied.

Headers

none

Receives Json

none

Returns Json

An array of Item objects

(see Item definition above)

Example:

[
  {
    "cases": [],
    "minimumQuantity": 1,
    "maximumQuantity": null,
    "manufacturerSuggestedRetailPrice": null,
    "viewUrl": "http://www.testajax.com/catalog/DEMO/products/facebook/fb-single/ATARI2600.html",
    "options": [],
    "allowBackorder": false,
    "preorder": false,
    "inventoryTracked": false,
    "availableQuantity": 0,
    "inStock": true,
    "itemOid": 3707319,
    "itemId": "ATARI2600",
    "description": "Atari 2600",
    "extendedDescription": "",
    "cost": 999.99,
    "weight": null,
    "length": {
      "uom": "CM",
      "value": 0
    },
    "width": {
      "uom": "CM",
      "value": 0
    },
    "height": {
      "uom": "CM",
      "value": 0
    },
    "attributes": [],
    "multimedias": [
      {
        "thumbnails": [
          {
            "height": 80,
            "width": 80,
            "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1347411615246/DEMO/4/6/80-80-466058B5603717FE5D5B2F1302FC06F0.jpg",
            "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1347411615246/DEMO/4/6/80-80-466058B5603717FE5D5B2F1302FC06F0.jpg"
          },
          {
            "height": 100,
            "width": 100,
            "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1363399269313/DEMO/4/6/100-100-466058B5603717FE5D5B2F1302FC06F0.jpg",
            "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1363399269313/DEMO/4/6/100-100-466058B5603717FE5D5B2F1302FC06F0.jpg"
          },
          {
            "height": 200,
            "width": 200,
            "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1363399250806/DEMO/4/6/200-200-466058B5603717FE5D5B2F1302FC06F0.jpg",
            "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1363399250806/DEMO/4/6/200-200-466058B5603717FE5D5B2F1302FC06F0.jpg"
          }
        ],
        "type": "Image",
        "default": true,
        "imageWidth": 600,
        "imageHeight": 335,
        "viewUrl": "http://s3.amazonaws.com/ultracart/im/3F44E1FC096C0E0131DF4BBF5B051400?AWSAccessKeyId=0P4TXH5AKGYC8WHDZFG2&Expires=1371107686&Signature=EM5lMfjnmWk4ak2z6DVjEJ2uueg%3D",
        "description": "",
        "code": null,
        "excludeFromGallery": false
      }
    ],
    "defaultImageUrl": "http://s3.amazonaws.com/ultracart/im/3F44E1FC096C0E0131DF4BBF5B051400?AWSAccessKeyId=0P4TXH5AKGYC8WHDZFG2&Expires=1371107686&Signature=EM5lMfjnmWk4ak2z6DVjEJ2uueg%3D",
    "defaultThumbnailUrl": "http://ultracartthumbs.s3.amazonaws.com/1347411615246/DEMO/4/6/80-80-466058B5603717FE5D5B2F1302FC06F0.jpg",
    "variations": []
  },

... additional items here ...

]

Code Block

language	javascript
theme	DJango
linenumbers	true

function items() {
    var merchantId = jQuery('#itemsMerchantId').val() || 'DEMO';
    var items = jQuery('#itemsField').val() || '';
    items = items.split(','); // change the string into an array.
    var url = jQuery('#itemsUrlField').val() || '';
    var data = {
      _mid: merchantId,
      id: items,
      url: url
    };

    jQuery.ajax({
      url: '/rest/site/items',
      type: 'get',
      data: data,
      headers: {// 'X-UC-Merchant-Id': 'DEMO', // PASSING IN Merchant ID as parameter so you can try your own!
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'json'
    }).done(function (items) {
          jQuery('#itemsResult').html('<pre>' + JSON.stringify(items, null, '  ') + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#itemsButton').on('click', items);
  });

...

/rest/site/items/{item id}

Method	GET	Comments
Description	retrieves a single item
Cookies	none
Path Parameters	item id	this should be a valid merchant item id. For example: /rest/site/items/TSHIRT
Query Parameters	thumbnailSize cartId	optional integer: one of these values: 80, 100, 200, 220, 250, 500. This is an optional parameter. The default is 80px. Thumbnails are always square. `If a cart id is passed in as a query, the associated cart is loaded and referenced. If the cart has a logged in customer (valid customer profile), then any items returned will have their pricing applied.`
Headers	none
Receives Json	none
Returns Json	An Item object (see Item definition above)	Example: { "cases": [], "minimumQuantity": 1, "maximumQuantity": null, "manufacturerSuggestedRetailPrice": null, "viewUrl": "http://www.testajax.com/catalog/DEMO/products/facebook/fb-single/PDF.html", "options": [], "allowBackorder": false, "preorder": false, "inventoryTracked": false, "availableQuantity": -33, "inStock": true, "itemOid": 128754, "itemId": "PDF", "description": "PDF Sampler", "extendedDescription": "", "cost": 1, "weight": null, "length": { "uom": "IN", "value": 0 }, "width": { "uom": "IN", "value": 0 }, "height": { "uom": "IN", "value": 0 }, "attributes": [], "multimedias": [ { "thumbnails": [ { "height": 200, "width": 200, "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1363189011276/DEMO/F/D/200-200-FDDC193869B9EB22A7ADFA776F613062.jpg", "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1363189011276/DEMO/F/D/200-200-FDDC193869B9EB22A7ADFA776F613062.jpg" }, { "height": 100, "width": 100, "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1368717402788/DEMO/F/D/100-100-FDDC193869B9EB22A7ADFA776F613062.jpg", "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1368717402788/DEMO/F/D/100-100-FDDC193869B9EB22A7ADFA776F613062.jpg" }, { "height": 80, "width": 80, "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1369393305697/DEMO/F/D/80-80-FDDC193869B9EB22A7ADFA776F613062.jpg", "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1369393305697/DEMO/F/D/80-80-FDDC193869B9EB22A7ADFA776F613062.jpg" } ], "type": "Image", "default": true, "imageWidth": 400, "imageHeight": 400, "viewUrl": "http://s3.amazonaws.com/ultracart/im/317BBF705AEB5C0130BD546683051600?AWSAccessKeyId=0P4TXH5AKGYC8WHDZFG2&Expires=1371108852&Signature=RKlBcOafFfPuTGKovA9g%2FRSlAwo%3D", "description": "pdf icon", "code": null, "excludeFromGallery": false } ], "defaultImageUrl": "http://s3.amazonaws.com/ultracart/im/317BBF705AEB5C0130BD546683051600?AWSAccessKeyId=0P4TXH5AKGYC8WHDZFG2&Expires=1371108852&Signature=RKlBcOafFfPuTGKovA9g%2FRSlAwo%3D", "defaultThumbnailUrl": "http://ultracartthumbs.s3.amazonaws.com/1369393305697/DEMO/F/D/80-80-FDDC193869B9EB22A7ADFA776F613062.jpg", "variations": [] }

Code Block

language	javascript
theme	DJango
linenumbers	true

function singleItem() {
    var item = jQuery('#itemField').val() || '';
    jQuery.ajax({
      url: '/rest/site/items/' + item,
      type: 'get',
      headers: { 'X-UC-Merchant-Id': 'DEMO',
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'json'
    }).done(function (item) {
          jQuery('#itemResult').html('<pre>' + JSON.stringify(item, null, '  ') + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#itemButton').on('click', singleItem);
  });

...

/rest/site/items/{item id}/relatedItems

Method	GET	Comments
Description	retrieves an array of related items for a given item
Cookies	none
Path Parameters	`item id`	`this should be a valid merchant item id. For example: /rest/site/items/TSHIRT/relatedItems`
Query Parameters	`thumbnailSize` `_mid` `cartId`	`optional integer: one of these values: 80, 100, 200, 220, 250, 500. This is an optional parameter. The default is 80px. Thumbnails are always square.` `if the merchant id isn't included via a cookie or header, it will need to be provided as a query parameter: _mid=DEMO` `If a cart id is passed in as a query, the associated cart is loaded and referenced. If the cart has a logged in customer (valid customer profile), then any items returned will have their pricing applied.`
Headers	none
Receives Json	`none`
Returns Json	An Item object (each related item will be one of these) (see Item definition above)	Example: { "cases": [], "minimumQuantity": 1, "maximumQuantity": null, "manufacturerSuggestedRetailPrice": null, "viewUrl": "http://www.testajax.com/catalog/DEMO/products/facebook/fb-single/PDF.html", "options": [], "allowBackorder": false, "preorder": false, "inventoryTracked": false, "availableQuantity": -33, "inStock": true, "itemOid": 128754, "itemId": "PDF", "description": "PDF Sampler", "extendedDescription": "", "cost": 1, "weight": null, "length": { "uom": "IN", "value": 0 }, "width": { "uom": "IN", "value": 0 }, "height": { "uom": "IN", "value": 0 }, "attributes": [], "multimedias": [ { "thumbnails": [ { "height": 200, "width": 200, "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1363189011276/DEMO/F/D/200-200-FDDC193869B9EB22A7ADFA776F613062.jpg", "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1363189011276/DEMO/F/D/200-200-FDDC193869B9EB22A7ADFA776F613062.jpg" }, { "height": 100, "width": 100, "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1368717402788/DEMO/F/D/100-100-FDDC193869B9EB22A7ADFA776F613062.jpg", "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1368717402788/DEMO/F/D/100-100-FDDC193869B9EB22A7ADFA776F613062.jpg" }, { "height": 80, "width": 80, "httpUrl": "http://ultracartthumbs.s3.amazonaws.com/1369393305697/DEMO/F/D/80-80-FDDC193869B9EB22A7ADFA776F613062.jpg", "httpsUrl": "https://s3.amazonaws.com/ultracartthumbs/1369393305697/DEMO/F/D/80-80-FDDC193869B9EB22A7ADFA776F613062.jpg" } ], "type": "Image", "default": true, "imageWidth": 400, "imageHeight": 400, "viewUrl": "http://s3.amazonaws.com/ultracart/im/317BBF705AEB5C0130BD546683051600?AWSAccessKeyId=0P4TXH5AKGYC8WHDZFG2&Expires=1371108852&Signature=RKlBcOafFfPuTGKovA9g%2FRSlAwo%3D", "description": "pdf icon", "code": null, "excludeFromGallery": false } ], "defaultImageUrl": "http://s3.amazonaws.com/ultracart/im/317BBF705AEB5C0130BD546683051600?AWSAccessKeyId=0P4TXH5AKGYC8WHDZFG2&Expires=1371108852&Signature=RKlBcOafFfPuTGKovA9g%2FRSlAwo%3D", "defaultThumbnailUrl": "http://ultracartthumbs.s3.amazonaws.com/1369393305697/DEMO/F/D/80-80-FDDC193869B9EB22A7ADFA776F613062.jpg", "variations": [] }

Code Block

language	javascript
theme	DJango
linenumbers	true

function relatedItems() {
    var item = jQuery('#itemField').val() || '';
    jQuery.ajax({
      url: '/rest/site/items/' + item + '/relatedItems',
      type: 'get',
      headers: { 'X-UC-Merchant-Id': 'DEMO',
        "cache-control": "no-cache"}, // could also pass merchant id as query parameter named '_mid' or cookie named 'UltraCartMerchantId'
      dataType: 'json'
    }).done(function (items) {
          jQuery('#itemResult').html('<pre>' + JSON.stringify(items, null, '  ') + '</pre>');
        });
  }
  jQuery(document).ready(function () {
    jQuery('#relatedItemsButton').on('click', relatedItems);
  });

...

Ensure the login used to access secure.ultracart.com has "API Access". This may be granted by the account owner here: Configuration Manage Users Edit Configuration → Manage Users → Edit User.
Once permission is granted, navigate to Developer Tools Call Tools → Call History Log. It's a link in the Javascript Checkout API section.

...

Versions Compared

Old Version 12

New Version 13

Key

/rest/site/stateProvinces

/rest/site/stateProvinceCodes

/rest/site/storeFront/searchAutoSuggest

/rest/site/unifiedAffiliateCookieScript

/rest/site/advertisingSources

/rest/site/returnPolicy

/rest/site/allowedCountries

rest/site/customerIpAddress

/rest/site/items/search

/rest/site/items

/rest/site/items/{item id}

/rest/site/items/{item id}/relatedItems