Access Putler’s Analytics Stats in your own apps

Use Putler’s Outbound API to access Putler’s KPIs, lists and charts in your own apps.

  • Use Collection endpoints to pull all stats in a single call. Use Individual endpoint to pull only those stats that you need.
  • All calls will return data for current month, for account selected under Sharing tab, in currency selected under Sharing tab!
  • All API calls require your Putler email address and Sharing Token. You will receive an “Authentication failed” error if they are not passed / are invalid.
  • You can get your sharing token by checking “Enable Sharing” under Settings -> Sharing tab.

API Endpoints for Collections

Get all stats or only KPIs as you need. In one single call!

KPIs /kpi

Get KPIs

URL
https://api.putler.com/outbound/dashboard/kpi
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
kpiAll the KPIs
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi?email=your-email&token=your-token
Example Response
{"forecasted-sales": {"value": "$1,662.68","label": "Forecasted Sales"}, "month-to-date-sales": {"value": "$934.70","change": "-9316.52","label": "Month to Date Sales"}, "subscriptions-active": {"value": 2,"label": "Active Subscriptions"}, "subscriptions-new": {"value": 0,"label": "New Subscriptions"}, "fastest-moving-product": {"value": "Wrist Watch","label": "Fastest Moving Product"}, "returning-customers": {"value": "8 • 57.14%","label": "Returning Customers"}, "sales-frequency": {"value": "1d 2h","label": "Frequency: one sale every"}, "todays-sales": {"value": "$0.00","change": "0.00","label": "Today's Sales"}, "avg-revenue-per-sale": {"value": "$62.31","label": "Average Revenue / Sale"}, "avg-qty-sold-per-day": {"value": "1.17","label": "Average Qty Sold / Day"}, "qty-sold": {"value": 21,"label": "Qty Sold"}, "avg-revenue-per-day": {"value": "$53.63","label": "Average Revenue / Day"}, "monthly-target": {"value": "133.53%","target": "$700.0","label": "Target"}, "customers-acquired-per-day": {"value": "0.78","label": "Customers Acquired / Day"}, "avg-value-per-customer": {"value": "$66.76","label": "Average Value / Customer"}, "avg-orders-per-customer": {"value": "5.50","label": "Average Orders / Customer"}, "account-balance": {"value": "$40,237.41","change": "0.00","label": "Account Balance"}, "customers": {"value": 14,"label": "Customers"}, "refunded-customers": {"value": "5 • 35.71%","label": "Refunded Customers"}, "sales-before-refunds-count": {"label": "Sales Before Refunds Count","value": "16"}, "refunds-count": {"label": "Refunds Count","value": "34"}, "avg-sales-per-day": {"value": "$53.63","change": "-515.88","label": "Average Sales/Day"}, "sales-from-top-products": {"value": "$635.00 • 76.35%","label": "Sales From Top 20% Products"}, "refunds-amount": {"label": "Refunds Amount","value": "$62.30"}, "slowest-moving-product": {"value": "Flex Tutorials","label": "Slowest Moving Product"}, "sales-before-refunds-amount": {"label": "Sales Before Refunds Amount","value": "$997.00"}, "subscriptions-suspended": {"value": 0,"label": "Suspended Subscriptions"}, "subscriptions-failed": {"value": 0,"label": "Failed Subscriptions"}, "subscriptions-canceled": {"value": 0,"label": "Canceled Subscriptions"}}

Lists /lists

Get lists

URL
https://api.putler.com/outbound/dashboard/lists
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
listsSales, products and customers lists
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/lists?email=your-email&token=your-token
Example Response
{"products": { "headers": ["Item","Sales","Refunds","Total","Currency"], "data": [ ["Web Entrepreneurs' Club - Annual",2,0,298,"USD"], ["Web Entrepreneurs' Club Premium - Annual",1,0,199,"USD"], ["Putler's Guide to Sales Analysis - eBook",2,0,138,"USD"], ["Web Millionaire - Audio Book",2,0,98,"USD"] ] }, "customers": { "headers": ["Customer","Last On","Transactions","Total","Currency"], "data": [ ["Onyebuchi Onochie","2013-10-01 05:59:37",1,274,"USD"], ["Anton Millar","2013-10-03 22:23:06",3,199,"USD"], ["Meaza Dahlak","2013-10-04 13:00:06",1,149,"USD"], ["Tena Antolović","2013-10-03 16:57:15",1,90,"USD"] ] }, "sales": { "headers": ["Date","Customer","Status","Amount","Currency"], "data": [ ["2013-10-04 13:00:06","Meaza Dahlak","Completed",149,"USD"], ["2013-10-04 05:56:12","Din Pajović","Completed",29,"EUR"], ["2013-10-03 22:23:06","Anton Millar","Refunded",0,"AUD"], ["2013-10-03 16:57:15","Tena Antolović","Completed",90,"GBP"] ] }}

Charts /charts

Get charts

URL
https://api.putler.com/outbound/dashboard/charts
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
chartsSales, products and customers charts
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/charts?email=your-email&token=your-token
Example Response
{"products": { "xaxis": [1,2,3,4,5,6,7,8,9,10], "data": [[0,0,199,0,0,0,0,0,0,0],[138,0,0,0,0,0,0,0,0,0],[98,0,0,0,0,0,0,0,0,0],[7,0,120.2,29,0,0,0,0,8.19,67.19]], "labels": ["Web Entrepreneurs' Club Premium - Annual","Putler's Guide to Sales Analysis - eBook","Web Millionaire - Audio Book","Others"] }, "customers": { "xaxis": 1,2,3,4,5,6,7,8,9,10], "data": [[2,0,3,2,0,0,0,0,1,0],[1,0,1,0,0,0,0,0,2,2]], "labels": ["New","Returning"] }, "sales": { "xaxis": [1,2,3,4,5,6,7,8,9,10], "data": [[392,0,319.2,178,0,0,0,0,38.19,5.81]], "labels": ["Sales"] }}

All Stats that Putler offers /

Get all stats – KPIs, charts, lists, highlights, meta

URL
https://api.putler.com/outbound/dashboard
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
datakpi, lists, charts, meta, highlights
Example API call using cURL
curl https://api.putler.com/outbound/dashboard?email=your-email&token=your-token
Example Response
{"kpi": {{"forecasted-sales": {"value": "$1,662.68","label": "Forecasted Sales"}, "month-to-date-sales": {"value": "$934.70","change": "-9316.52","label": "Month to Date Sales"}, "subscriptions-active": {"value": 2,"label": "Active Subscriptions"}, "subscriptions-new": {"value": 0,"label": "New Subscriptions"}, "fastest-moving-product": {"value": "Wrist Watch","label": "Fastest Moving Product"}, "returning-customers": {"value": "8 • 57.14%","label": "Returning Customers"}, "sales-frequency": {"value": "1d 2h","label": "Frequency: one sale every"}, "todays-sales": {"value": "$0.00","change": "0.00","label": "Today's Sales"}, "avg-revenue-per-sale": {"value": "$62.31","label": "Average Revenue / Sale"}, "avg-qty-sold-per-day": {"value": "1.17","label": "Average Qty Sold / Day"}, "qty-sold": {"value": 21,"label": "Qty Sold"}, "avg-revenue-per-day": {"value": "$53.63","label": "Average Revenue / Day"}, "monthly-target": {"value": "133.53%","target": "$700.0","label": "Target"}, "customers-acquired-per-day": {"value": "0.78","label": "Customers Acquired / Day"}, "avg-value-per-customer": {"value": "$66.76","label": "Average Value / Customer"}, "avg-orders-per-customer": {"value": "5.50","label": "Average Orders / Customer"}, "account-balance": {"value": "$40,237.41","change": "0.00","label": "Account Balance"}, "customers": {"value": 14,"label": "Customers"}, "refunded-customers": {"value": "5 • 35.71%","label": "Refunded Customers"}, "sales-before-refunds-count": {"label": "Sales Before Refunds Count","value": "16"}, "refunds-count": {"label": "Refunds Count","value": "34"}, "avg-sales-per-day": {"value": "$53.63","change": "-515.88","label": "Average Sales/Day"}, "sales-from-top-products": {"value": "$635.00 • 76.35%","label": "Sales From Top 20% Products"}, "refunds-amount": {"label": "Refunds Amount","value": "$62.30"}, "slowest-moving-product": {"value": "Flex Tutorials","label": "Slowest Moving Product"}, "sales-before-refunds-amount": {"label": "Sales Before Refunds Amount","value": "$997.00"}, "subscriptions-suspended": {"value": 0,"label": "Suspended Subscriptions"}, "subscriptions-failed": {"value": 0,"label": "Failed Subscriptions"}, "subscriptions-canceled": {"value": 0,"label": "Canceled Subscriptions"} }},"meta": { "primary-currency": "USD", "to-date": "2013-10-18 10:15:40", "currency": "USD", "from-date": "2013-10-01 00:00:00" },"charts": {"products": { "xaxis": [1,2,3,4,5,6,7,8,9,10], "data": [[0,0,199,0,0,0,0,0,0,0],[138,0,0,0,0,0,0,0,0,0],[98,0,0,0,0,0,0,0,0,0],[7,0,120.2,29,0,0,0,0,8.19,67.19]], "labels": ["Web Entrepreneurs' Club Premium - Annual","Putler's Guide to Sales Analysis - eBook","Web Millionaire - Audio Book","Others"] },"customers": { "xaxis": 1,2,3,4,5,6,7,8,9,10], "data": [[2,0,3,2,0,0,0,0,1,0],[1,0,1,0,0,0,0,0,2,2]], "labels": ["New","Returning"] },"sales": { "xaxis": [1,2,3,4,5,6,7,8,9,10], "data": [[392,0,319.2,178,0,0,0,0,38.19,5.81]], "labels": ["Sales"] } },"highlights": [ "Balance: $36,838.29, Sample Data", "Balance: $9,989.17, Paypal", "Balance: $30,248.24, 2Checkout", "Today: 0 customers, 0 items sold, 0 transactions ", "Last Transaction: PayPal, Other, $0.02", "Yesterday: Sales $0.00" ],"lists": {"products": { "headers": ["Item","Sales","Refunds","Total","Currency"], "data": [ ["Web Entrepreneurs' Club - Annual",2,0,298,"USD"], ["Web Entrepreneurs' Club Premium - Annual",1,0,199,"USD"], ["Putler's Guide to Sales Analysis - eBook",2,0,138,"USD"], ["Web Millionaire - Audio Book",2,0,98,"USD"] ] }, "customers": { "headers": ["Customer","Last On","Transactions","Total","Currency"], "data": [ ["Onyebuchi Onochie","2013-10-01 05:59:37",1,274,"USD"], ["Anton Millar","2013-10-03 22:23:06",3,199,"USD"], ["Meaza Dahlak","2013-10-04 13:00:06",1,149,"USD"], ["Tena Antolović","2013-10-03 16:57:15",1,90,"USD"] ] }, "sales": { "headers": ["Date","Customer","Status","Amount","Currency"], "data": [ ["2013-10-04 13:00:06","Meaza Dahlak","Completed",149,"USD"], ["2013-10-04 05:56:12","Din Pajović","Completed",29,"EUR"], ["2013-10-03 22:23:06","Anton Millar","Refunded",0,"AUD"], ["2013-10-03 16:57:15","Tena Antolović","Completed",90,"GBP"] ] }}}

API Endpoints for Individual Stats

Want to access a particular KPI? Use individual endpoints!

Account Balance /kpi/account-balance

Get the account balance

URL
https://api.putler.com/outbound/dashboard/kpi/account-balance
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueThe total balance for selected accounts
changeDifference between current and the previous balance
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/account-balance?email=your-email&token=your-token
Example Response
{"value": "$40,203.00","change": "9951.69","label": "Account Balance"}

Today’s Sales /kpi/todays-sales

Get today’s sales amount

URL
https://api.putler.com/outbound/dashboard/kpi/todays-sales
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueToday’s sales for selected accounts
changeDifference between today’s sales and yesterday’s sales
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/todays-sales?email=your-email&token=your-token
Example Response
{"value": "$392.00","change": "392.00","label": "Today's Sales"}

Month To Date Sales /kpi/month-to-date-sales

Get current month’s sales amount

URL
https://api.putler.com/outbound/dashboard/kpi/month-to-date-sales
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueCurrent month’s sales for selected accounts
changeDifference between current month’s sales and last month’s sales
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/month-to-date-sales?email=your-email&token=your-token
Example Response
{"value": "$392.00","change": "-38.87","label": "Month to Date Sales"}

Forecasted Sales /kpi/forecasted-sales

Get forecasted sales for current month

URL
https://api.putler.com/outbound/dashboard/kpi/forecasted-sales
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueCurrent month’s forecasted sales for selected accounts
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/forecasted-sales?email=your-email&token=your-token
Example Response
{"value": "$22,011.17","label": "Forecasted Sales"}

Average Sales / Day /kpi/avg-sales-per-day

Get average sale per day

URL
https://api.putler.com/outbound/dashboard/kpi/avg-sales-per-day
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueAverage Sales per day
changeDifference between today’s and yesterday’s average sales/day
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/avg-sales-per-day?email=your-email&token=your-token
Example Response
{"value": "$392.00","change": "-38.87","label": "Average Sales/Day"}

Monthly Target /kpi/monthly-target

Get progress of monthly target set for current month

URL
https://api.putler.com/outbound/dashboard/kpi/monthly-target
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valuePercentage of monthly target achieved
targetMonthly target set
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/monthly-target?email=your-email&token=your-token
Example Response
{"value": "196.00%","change": "of $200.00","label": "Target"}

Sales Before Refunds Amount /kpi/sales-before-refunds-amount

Get sales before refunds amount for current month

URL
https://api.putler.com/outbound/dashboard/kpi/sales-before-refunds-amount
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueSales amount
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/sales-before-refunds-amount?email=your-email&token=your-token
Example Response
{"value": "$323.00","label": "Sales Before Refunds Amount"}

Sales Before Refunds Count /kpi/sales-before-refunds-count

Get count of sales for current month

URL
https://api.putler.com/outbound/dashboard/kpi/sales-before-refunds-count
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber of Sales
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/sales-before-refunds-count?email=your-email&token=your-token
Example Response
{"value": "32","label": "Sales Before Refunds Count"}

Refunds Amount /kpi/refunds-amount

Get refunded amount for current month

URL
https://api.putler.com/outbound/dashboard/kpi/refunds-amount
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueRefunds amount
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/refunds-amount?email=your-email&token=your-token
Example Response
{"value": "$29.00","label": "Refunds Amount"}

Refunds Count /kpi/refunds-count

Get count of refunds for current month

URL
https://api.putler.com/outbound/dashboard/kpi/refunds-count
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueRefunds count
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/refunds-count?email=your-email&token=your-token
Example Response
{"value": "14","label": "Refunds Count"}

Average Revenue / Sale /kpi/avg-revenue-per-sale

Get the average revenue earned per sale for current month

URL
https://api.putler.com/outbound/dashboard/kpi/avg-revenue-per-sale
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueAverage revenue earned per sale
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/avg-revenue-per-sale?email=your-email&token=your-token
Example Response
{"value": "$91.82","label": "Average Revenue / Sale"}

Average Revenue / Day /kpi/avg-revenue-per-day

Get the average revenue earned per day for current month

URL
https://api.putler.com/outbound/dashboard/kpi/avg-revenue-per-day
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueAverage revenue earned per day
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/avg-revenue-per-day?email=your-email&token=your-token
Example Response
{"value": "$133.74","label": "Average Revenue / Day"}

Active Subscriptions /kpi/subscriptions-active

Get the number of active subscriptions in current month

URL
https://api.putler.com/outbound/dashboard/kpi/subscriptions-active
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber of active subscriptions
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/subscriptions-active?email=your-email&token=your-token
Example Response
curl /kpi/subscriptions-active -d 'email=your-email' -d 'token=your-token'

New Subscriptions /kpi/subscriptions-new

Get the number of new subscriptions in current month

URL
https://api.putler.com/outbound/dashboard/kpi/subscriptions-new
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber of new subscriptions
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/subscriptions-new?email=your-email&token=your-token
Example Response
{"value": 1,"label": "New Subscriptions"}

Canceled Subscriptions /kpi/subscriptions-canceled

Get the number of subscriptions canceled in current month

URL
https://api.putler.com/outbound/dashboard/kpi/subscriptions-canceled
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber of subscriptions canceled
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/subscriptions-canceled?email=your-email&token=your-token
Example Response
{"value": 2,"label": "Canceled Subscriptions"}

Failed Subscriptions /kpi/subscriptions-failed

Get the number of subscriptions failed in current month

URL
https://api.putler.com/outbound/dashboard/kpi/subscriptions-failed
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber of subscriptions failed
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/subscriptions-failed?email=your-email&token=your-token
Example Response
{"value": 0,"label": "Failed Subscriptions"}

Suspended Subscriptions /kpi/subscriptions-suspended

Get the number of subscriptions suspended in current month

URL
https://api.putler.com/outbound/dashboard/kpi/subscriptions-suspended
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber of subscriptions suspended
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/subscriptions-suspended?email=your-email&token=your-token
Example Response
{"value": 1,"label": "Suspended Subscriptions"}

Sales Frequency /kpi/sales-frequency

Get average interval between two sales for current month

URL
https://api.putler.com/outbound/dashboard/kpi/sales-frequency
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueFrequency of sale
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/sales-frequency?email=your-email&token=your-token
Example Response
{"value": "15h 57min","label": "Frequency: one sale every"}

Sales From Top 20% Products /kpi/sales-from-top-products

Get sales from the top 20% products for current month

URL
https://api.putler.com/outbound/dashboard/kpi/sales-from-top-products
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueSales from top 20% products
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/sales-from-top-products?email=your-email&token=your-token
Example Response
{"value": "$497.00 • 55.89%","label": "Sales From Top 20% Products"}

Quantity Sold /kpi/qty-sold

Get quantity of products sold for current month

URL
https://api.putler.com/outbound/dashboard/kpi/qty-sold
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueQuantity of products sold
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/qty-sold?email=your-email&token=your-token
Example Response
{"value": 13,"label": "Qty Sold"}

Average Quantity Sold / Day /kpi/avg-qty-sold-per-day

Get the average quantity sold per day for current month

URL
https://api.putler.com/outbound/dashboard/kpi/avg-qty-sold-per-day
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueAverage quantity sold per day
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/avg-qty-sold-per-day?email=your-email&token=your-token
Example Response
{"value": "1.86","label": "Average Qty Sold / Day"}

Fastest Moving Product /kpi/fastest-moving-product

Get the fastest moving product for current month

URL
https://api.putler.com/outbound/dashboard/kpi/fastest-moving-product
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueFastest Moving Product
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/fastest-moving-product?email=your-email&token=your-token
Example Response
{"value": "Web Millionaire - eBook","label": "Fastest Moving Product"}

Slowest Moving Product /kpi/slowest-moving-product

Get the fastest moving product for current month

URL
https://api.putler.com/outbound/dashboard/kpi/slowest-moving-product
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueSlowest Moving Product
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/slowest-moving-product?email=your-email&token=your-token
Example Response
{"value": "Photography Tutorials","label": "Slowest Moving Product"}

Customers /kpi/customers

Get the number of customers for current month

URL
https://api.putler.com/outbound/dashboard/kpi/customers
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber of Customers
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/customers?email=your-email&token=your-token
Example Response
{"value": 9,"label": "Customers"}

Customers Acquired / Day /kpi/customers-acquired-per-day

Get the number of customers acquired per day for current month

URL
https://api.putler.com/outbound/dashboard://api.putler.com/outbound/kpi/customers-acquired-per-day
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber of customers acquired per day
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard://api.putler.com/outbound/kpi/customers-acquired-per-day?email=your-email&token=your-token
Example Response
{"value": "1.29","label": "Customers Acquired / Day"}

Returning Customers /kpi/returning-customers

Get the number and percentage of returning customers for current month

URL
https://api.putler.com/outbound/dashboard/kpi/returning-customers
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber and percentage of returning customers
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/returning-customers?email=your-email&token=your-token
Example Response
{"value": "3 • 33.33%","label": "Returning Customers"}

Refunded Customers /kpi/refunded-customers

Get the number and percentage of customers refunded for current month

URL
https://api.putler.com/outbound/dashboard/kpi/refunded-customers
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueNumber and percentage of customers refunded
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/refunded-customers?email=your-email&token=your-token
Example Response
{"value": "1 • 11.11%","label": "Refunded Customers"}

Average Value Per Customer /kpi/avg-value-per-customer

Get the number and percentage of customers refunded for current month

URL
https://api.putler.com/outbound/dashboard/kpi/avg-value-per-customer
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueAverage value per customer
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/avg-value-per-customer?email=your-email&token=your-token
Example Response
{"value": "$73.87","label": "Average Value / Customer"}

Average Orders Per Customer /kpi/avg-orders-per-customer

Get the number and percentage of customers refunded for current month

URL
https://api.putler.com/outbound/dashboard/kpi/avg-orders-per-customer
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
valueAverage orders per customer
labelKPI Label
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/kpi/avg-orders-per-customer?email=your-email&token=your-token
Example Response
{"value": "5.50","label": "Average Orders / Customer"}

Sales List /lists/sales

Get the list of sales for current month

URL
https://api.putler.com/outbound/dashboard/lists/sales
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
headerHeader labels for sales list
dataList of sales
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/lists/sales?email=your-email&token=your-token
Example Response
{"headers": ["Date","Customer","Status","Amount","Currency"],"data": [["2013-10-04 13:00:06","Meaza Dahlak","Completed",149,"USD"],["2013-10-04 05:56:12","Din Pajović","Completed",29,"EUR"],["2013-10-03 22:23:06","Anton Millar","Refunded",0,"AUD"],["2013-10-03 16:57:15","Tena Antolović","Completed",90,"GBP"],["2013-10-03 04:46:12","Cary Fagan","Completed",29,"USD"],["2013-10-01 15:30:22","Margrét Skúladóttir","Completed",69,"EUR"]]}

Products List /lists/products

Get the list of products for current month

URL
https://api.putler.com/outbound/dashboard/lists/products
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
headerHeader labels for products list
dataList of products
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/lists/products?email=your-email&token=your-token
Example Response
{"headers": ["Item","Sales","Refunds","Total","Currency"],"data": [["Web Entrepreneurs' Club - Annual",2,0,298,"USD"],["Web Entrepreneurs' Club Premium - Annual",1,0,199,"USD"],["Putler's Guide to Sales Analysis - eBook",2,0,138,"USD"],["Web Millionaire - Audio Book",2,0,98,"USD"],["Wordpress Theme Pack for Web Businesses",1,0,90,"USD"],["Putler's Guide to Sales Analysis - Audio Book",1,0,29,"USD"]]}

Customers List /lists/customers

Get the list of customers for current month

URL
https://api.putler.com/outbound/dashboard/lists/customers
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
headerHeader labels for customers list
dataList of customers
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/lists/customers?email=your-email&token=your-token
Example Response
{"headers": ["Customer","Last On","Transactions","Total","Currency"],"data": [["Onyebuchi Onochie","2013-10-01 05:59:37",1,274,"USD"],["Anton Millar","2013-10-03 22:23:06",3,199,"USD"],["Meaza Dahlak","2013-10-04 13:00:06",1,149,"USD"],["Tena Antolović","2013-10-03 16:57:15",1,90,"USD"],["Margrét Skúladóttir","2013-10-01 15:30:22",1,69,"USD"]]}

Sales Chart /charts/sales

Get the sales chart for current month

URL
https://api.putler.com/outbound/dashboard/charts/sales
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
xaxisDates of current month
dataSeries value for sales chart
labelsLabels for sales chart
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/charts/sales?email=your-email&token=your-token
Example Response
{"xaxis": [1,2,3,4,5,6,7,8,9,10],"data": [[392,0,319.2,178,0,0,0,0,38.19,5.81]],"labels": ["Sales"]}

Products Chart /charts/products

Get the products chart for current month

URL
https://api.putler.com/outbound/dashboard/charts/products
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
xaxisDates of current month
dataSeries value for products chart
labelsLabels for products chart
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/charts/products?email=your-email&token=your-token
Example Response
{"xaxis": [1,2,3,4,5,6,7,8,9,10],"data": [[149,0,0,149,0,0,0,0,0,0],[0,0,199,0,0,0,0,0,0,0],[138,0,0,0,0,0,0,0,0,0],[98,0,0,0,0,0,0,0,0,0]],"labels": ["Web Entrepreneurs' Club - Annual","Putler's Guide to Sales Analysis - eBook","Web Millionaire - Audio Book","Others"]}

Customers Chart /charts/customers

Get the customers chart for current month

URL
https://api.putler.com/outbound/dashboard/charts/customers
HTTP Method
GET
Input Parameters
ParameterDescription
emailThe email you use to login to Putler.
tokenToken generated from Putler for sharing data.
Data Returned
ParameterDescription
xaxisDates of current month
dataSeries value for customers chart
labelsLabels for customers chart
Example API call using cURL
curl https://api.putler.com/outbound/dashboard/charts/customers?email=your-email&token=your-token
Example Response
{"xaxis": [1,2,3,4,5,6,7,8,9,10],"data": [[2,0,3,2,0,0,0,0,1,0],[1,0,1,0,0,0,0,0,2,2]],"labels": ["New","Returning"]}

[/vc_column_text]

Common Error Messages

It is possible that while using the API, you may come across some errors. Refer the table below to better understand the error messages.

Error MessageDescription
Authentication requiredEmail or token not sent
Authentication failedEmail or token is invalid or incorrect
Requested data not found or is invalidURL is invalid or misspelt
[/vc_column][/vc_row]