Retrieving a List of Products from our API

Introduction

Although it's mostly undocumented, we do actually have a public API to perform certain operations on your Cart66 Cloud account. One of those is to retrieve a list of the products in your account. Here is a detailed guide on how to use our API to retrieve a list of your products.

Authentication

Our API uses HTTP Basic Authentication to authenticate requests coming in. However, we only use the Username part of the authentication, not the Password value.

To add a valid authentication header to your request, you'll just want to include your Cart66 Cloud account's Secret Key as the Username value.

Retrieving a List of Products

GET https://api.cart66.com/1/products

Here is an example using cURL:

curl -u <your_secret_key>: -H "Accept: application/json" https://api.cart66.com/1/products

This will retrieve a list of all of the products in your Cart66 Cloud account formatted as JSON.

Here is an example JSON response for that request:

[
  { 
    "id":"58d2b552d2a57d7515000925",
    "name":"Braves Shirt",
    "sku":"braves-shirt-01",
    "price":"22.95",
    "on_sale":true,
    "sale_price":"18.95",
    "currency":"$",
    "expires_after":null,
    "formatted_price":"$22.95",
    "formatted_sale_price":"$18.95",
    "digital":false,
    "type":"product",
    "status":"available"
  },
  { 
    "id":"58d2b552d2a57d7515000929",
    "name":"Braves Hat",
    "sku":"braves-hat-01",
    "price":"15.95",
    "on_sale":true,
    "sale_price":"10.95",
    "currency":"$",
    "expires_after":null,
    "formatted_price":"$15.95",
    "formatted_sale_price":"$10.95",
    "digital":false,
    "type":"product",
    "status":"available"
  }
]

Here is a list of the attributes we include for each product:

Name Type Description
id string Our Internal ID
name string Display name of the product
sku string SKU of the product
price decimal Price of the product as a decimal (e.g. 10.95)
on_sale boolean Whether or not this product is on sale
sale_price decimal Sale price of the product (e.g. 7.95)
currency string Currency symbol (e.g. $)
expires_after integer Number of days before this product expires
formatted_price string Display friendly price with currency (e.g. $10.95)
formatted_sale_price string Display friendly sale price with currency (e.g. $7.95)
digital boolean Whether or not this product has digital files attached to it
type string e.g. product, membership, subscription
status string Availability of this product (e.g. available, unavailable)

Still need help? Contact Us Contact Us