List all products

GET https://api.tamio.com/v2/products/list

Returns a paginated list of products with extensive filtering, sorting, and data-inclusion options. Use the attributes array to control which extra data blocks (stock, gallery, variations, etc.) are included.

Query Parameters

page integer*

per_page integer*

order string

ascdesc

sort_by string

namepricedatepostedstockweightlength

widthheightisbnupcskueangtinmpnbrandmodelasinbillingcyclecycle_intervaltrialhscodeshowndiscount_allowedexclude_from_feedon_saledelivery_typelicense_type

filter string

Text search against product names

type string

Filter by product type

physical_productsdigital_productsservicesbilling_plansphysical_servicesdigital_services

warehouse_productsdiscount_productsaffiliate_programswhitelabel_plansmossno_billing_plans

attributes array of string

Extra data blocks to include in each product object

from string

Start date filter (ISO format or Unix timestamp)

to string

End date filter (ISO format or Unix timestamp)

currency string

tax_classification string

site_id string

category_id string

category_ids array of string

include_category_descendands boolean

warehouse_id string

teammate_id string

discount_id string

custom_attribute_id string

direct_link_id string

affiliate_program_id string

automation_id string

related_product_id string

tax_id string

asset_id string

shown string

enableddisabled

on_sale string

enableddisabled

discounts string

enableddisabled

stock string

Filter by stock management status

enableddisabled

has_stock boolean

minimum_price number

maximum_price number

delivery_type string

fileurl

license_type string

listautogeneratednone

billing_cycle string

dayweekmonthyear

trial string

enableddisabled

complete_results boolean

Responses

200 Products retrieved successfully

Products retrieved successfully

status integer

total_results integer

products array of Product

400 Bad request. Possible `error_code` values:

Bad request. Possible error_code values:

Code	Description
`1002`	ResourceNotFound
`10060`	ProductQuotaReached
`10065`	InvalidCategory
`10066`	InvalidStock
`10067`	InvalidMinMaxUnits
`10070`	LanguageConfigurationMismatch
`10298`	SubscriptionMethodsNotActivated
`10320`	InvalidClientId
`10362`	InvalidDateRange
`10363`	InvalidCustomFields
`10365`	DigitalFilesNotFound
`10367`	WarehouseNotFound

status integer

error string

error_code integer

401 Missing or invalid API key

Retrieve a product

/products/list

1 const response = await fetch("https://api.tamio.com/v2/products/list", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/products/list")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "total_results": 142,
  "products": []
}

1	const response = await fetch("https://api.tamio.com/v2/products/list", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/products/list")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body