Skip to content
CatalogProducts

List products

Returns a paginated product list using the supplied catalog filters.

Query Parameters

limit?integer

Maximum number of results to return.

Formatint32
cursor?string

Cursor from the previous response. Omit it on the first page.

search?string

Free-text search.

sortBy?string

Field to sort by.

sortDirection?string

Sort direction: asc or desc.

Value in

  • "asc"
  • "desc"
searchNameAndSkuOnly?boolean

Match search only in the product name, product SKU and variant SKUs, not in the description or barcodes. Defaults to false.

productIds?array<ResourceId>

Only these products.

status?array<>

Only items in these statuses.

Value in

  • "draft"
  • "active"
  • "inactive"
  • "outOfStock"
  • "discontinued"
  • "archived"
excludeStatus?array<>

Leave out items in these statuses.

Value in

  • "draft"
  • "active"
  • "inactive"
  • "outOfStock"
  • "discontinued"
  • "archived"
includeArchived?boolean

Include archived items.

categoryIds?array<ResourceId>

Only items in these categories.

includeSubcategories?boolean

Also match products in the subcategories of categoryIds, at any depth. Defaults to false.

excludeCategoryIds?array<ResourceId>

Leave out items in these categories.

brandIds?array<ResourceId>

Only items of these brands.

excludeBrandIds?array<ResourceId>

Leave out items of these brands.

storeIds?array<ResourceId>

Only items of these stores.

sellerIds?array<ResourceId>

Only items of these sellers.

excludeSellerIds?array<ResourceId>

Leave out items of these sellers.

skuIds?array<ResourceId>

Filter by variant identifiers.

skus?array<string>

Filter by SKU codes.

types?array<>

Only these product types.

Value in

  • "product"
  • "service"
  • "bundle"
excludeTypes?array<>

Leave out these product types.

Value in

  • "product"
  • "service"
  • "bundle"
isFeatured?boolean

Only featured items.

ean?string

Filter by EAN barcode.

minPrice?number

Lowest price to include, in the store currency.

Formatdouble
maxPrice?number

Highest price to include, in the store currency.

Formatdouble
minDiscountPercent?number

Keeps 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.

Formatdouble
minOnHand?integer

Minimum stock on hand.

Formatint32
maxOnHand?integer

Maximum stock on hand.

Formatint32
minAvailable?integer

Minimum stock available to sell.

Formatint32
tags?array<string>

Only items with any of these tags.

excludeTags?array<string>

Leave out items with any of these tags.

includeVariants?boolean

Include each product's variants in the response.

includeTotalCount?boolean

Include the total number of matches. Slower on large catalogs.

projection?string

How much of each item to return.

Value in

  • "summary"
  • "full"
channelIds?array<ResourceId>

Only items from these sales channels.

sourceIds?array<ResourceId>

Only items imported from these sources.

modifierGroupIds?array<ResourceId>

Only items that use these customizations.

Header Parameters

x-Store-Id?string

Store the request acts on. Not needed when the token is bound to a store.

Authorization*string

OAuth 2.0 bearer token.

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}