List products
Returns a paginated product list using the supplied catalog filters.
Query Parameters
Maximum number of results to return.
int32Cursor from the previous response. Omit it on the first page.
Free-text search.
Field to sort by.
Sort direction: asc or desc.
Value in
- "asc"
- "desc"
Match search only in the product name, product SKU and variant SKUs, not in the description or barcodes. Defaults to false.
Only these products.
Only items in these statuses.
Value in
- "draft"
- "active"
- "inactive"
- "outOfStock"
- "discontinued"
- "archived"
Leave out items in these statuses.
Value in
- "draft"
- "active"
- "inactive"
- "outOfStock"
- "discontinued"
- "archived"
Include archived items.
Only items in these categories.
Also match products in the subcategories of categoryIds, at any depth. Defaults to false.
Leave out items in these categories.
Only items of these brands.
Leave out items of these brands.
Only items of these stores.
Only items of these sellers.
Leave out items of these sellers.
Filter by variant identifiers.
Filter by SKU codes.
Only these product types.
Value in
- "product"
- "service"
- "bundle"
Leave out these product types.
Value in
- "product"
- "service"
- "bundle"
Only featured items.
Filter by EAN barcode.
Lowest price to include, in the store currency.
doubleHighest price to include, in the store currency.
doubleKeeps products whose price is at least this percent below their compare-at price, both taken from the cheapest active variant. Greater than 0 and at most 100.
doubleMinimum stock on hand.
int32Maximum stock on hand.
int32Include each product's variants in the response.
Include the total number of matches. Slower on large catalogs.
How much of each item to return.
Value in
- "summary"
- "full"
Only items from these sales channels.
Only items imported from these sources.
Only items that use these customizations.
Header Parameters
Store the request acts on. Not needed when the token is bound to a store.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.ecomiq.pe/api/v1/catalog/products" \ -H "x-Store-Id: <store-id>" \ -H "Authorization: Bearer <token>"{ "data": [ { "id": "7204558912004322039", "sku": "POL-001-AZ-M", "storeId": "7204558912004327977", "sellerId": "7204558912004323447", "type": "product", "name": "Polo de algodón", "description": "Polo de algodón pima para uso diario.", "slug": "polo-de-algodon", "currency": "PEN", "taxRate": 18, "brand": "Andina", "price": 89, "compareAtPrice": 99, "costPrice": 40, "totalOnHand": 24, "available": 24, "committed": 1, "totalVariants": 24, "activeVariants": 1, "tracksInventory": true, "vendor": "Polo de algodón", "tags": [ "algodón" ], "specifications": [ { "name": "Polo de algodón", "key": "color", "value": "Polo de algodón", "fromSeller": false } ], "images": [ { "id": "7204558912004322039", "url": "https://mi-tienda.ecomiq.app/products/polo-de-algodon", "name": "Polo de algodón", "width": 30, "height": 30, "isPrimary": true, "order": 1, "type": "Polo de algodón" } ], "category": "Polos", "packageId": "7204558912004325646", "shippingProfileId": "7204558912004329819", "status": "draft", "metaTitle": "Polo de algodón", "metaDescription": "Polo de algodón pima para uso diario.", "metaKeywords": [ "Polo de algodón" ], "featuredUntil": "2026-09-28T15:30:00Z", "isFeatured": false, "minOrderQuantity": 2, "maxOrderQuantity": 2, "isDigital": false, "hasVariants": false, "hasActivity": false, "hasPriceLists": false, "hasReviews": false, "hasSizeGuide": false, "hasModifiers": false, "variants": [ { "id": "7204558912004323197", "storeId": "7204558912004327977", "productId": "7204558912004322039", "version": 3, "packageId": "7204558912004325646", "name": "Polo de algodón Azul / M", "sku": "POL-001-AZ-M", "barcode": "7751234567892", "countryOfOrigin": "Polo de algodón Azul / M", "hsCode": "POL-001", "order": 1, "isDefault": true, "price": 89, "compareAtPrice": 99, "costPrice": 40, "currency": "PEN", "isDigital": false, "trackInventory": true, "allowBackorders": false, "lowStockThreshold": 24, "weight": 0.3, "width": 30, "height": 30, "length": 30, "unitOfMeasure": "kilogram", "onHand": 24, "committed": 1, "available": 24, "options": [ { "name": "Polo de algodón Azul / M", "key": "color", "value": "Polo de algodón Azul / M" } ], "images": [ { "imageId": "7204558912004329435", "order": 1, "isPrimary": true } ], "inventories": [ { "id": "7204558912004326619", "locationId": "7204558912004328277", "onHand": 24, "committed": 1, "available": 24, "incoming": 1, "unavailable": 24, "version": 3, "createdOn": "2026-09-28T15:30:00Z", "updatedOn": "2026-09-28T15:30:00Z" } ], "status": "outOfStock", "createdOn": "2026-09-28T15:30:00Z", "updatedOn": "2026-09-28T15:30:00Z" } ], "views": 1, "salesCount": 24, "reviewsCount": 24, "createdOn": "2026-09-28T15:30:00Z", "updatedOn": "2026-09-28T15:30:00Z", "lastActivityOn": "2026-09-28T15:30:00Z" } ], "hasNextPage": true, "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ", "totalCount": 24}