Query Parameters
Number of products to return (default: 20, max: 100)
Number of products to skip (for pagination)
Cursor for pagination (alternative to offset)
Filter by status: “active”, “draft”, or “archived”
Filter by product category
Search products by name, SKU, or description
Filter by exact SKU match
Filter by tags (comma-separated)
Minimum price filter (in cents)
Maximum price filter (in cents)
Filter products with available inventory
Filter products below low stock threshold
Filter products created after this date (ISO 8601)
Filter products created before this date (ISO 8601)
Filter products updated after this date (ISO 8601)
Sort field: “created_at”, “updated_at”, “name”, “price”, “sku” (default: “created_at”)
Sort order: “asc” or “desc” (default: “desc”)
Include variant details in response (default: false)
Include inventory summary (default: false)
Response
Whether there are more products to retrieve
Total number of products matching the filters
Cursor for retrieving the next page
curl --location --request GET 'https://api.stateset.com/v1/products?limit=10&status=active&category=Electronics' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"object": "list",
"data": [
{
"id": "prod_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "product",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T14:22:00Z",
"name": "Wireless Bluetooth Headphones",
"sku": "WBH-001",
"description": "Premium noise-cancelling wireless headphones with 30-hour battery life",
"category": "Electronics",
"brand": "AudioTech",
"status": "active",
"price": {
"amount": 14999,
"currency": "USD",
"compare_at": 19999
},
"inventory_summary": {
"total_quantity": 150,
"available_quantity": 145,
"reserved_quantity": 5
},
"tags": ["electronics", "audio", "wireless", "bluetooth"]
},
{
"id": "prod_1234567890abcdef",
"object": "product",
"created_at": "2024-01-14T09:15:00Z",
"updated_at": "2024-01-14T09:15:00Z",
"name": "USB-C Charging Cable",
"sku": "USB-C-001",
"description": "Fast charging USB-C cable, 6ft length",
"category": "Electronics",
"brand": "TechConnect",
"status": "active",
"price": {
"amount": 1299,
"currency": "USD",
"compare_at": null
},
"inventory_summary": {
"total_quantity": 500,
"available_quantity": 487,
"reserved_quantity": 13
},
"tags": ["electronics", "cables", "charging"]
}
],
"has_more": true,
"total_count": 42,
"next_cursor": "eyJpZCI6InByb2RfMTIzNDU2Nzg5MGFiY2RlZiJ9"
}
