---
title: "listProducts - List products from your Mirakl Connect catalog"
method: GET
path: "/products"
tags: ["Catalog"]
---

# listProducts - List products from your Mirakl Connect catalog

`GET /products`

<div class="extension-title">Description</div>

Use this API to retrieve products imported in your Mirakl Connect catalog. Items are sorted by product identifiers.

<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: Synchronous: every 5 minutes</div>
<div class="max-call-frequency">Maximum usage: Synchronous: once per minute</div>
<div class="extension-title">Pagination</div>

<p>This resource supports seek pagination (<a href="#section/Seek-pagination-and-sort">see documentation</a>)</p>

</div>

## Query parameters

- `page_token` string
- `limit` integer

## Response `200`

List of products

- ListProductsResponse
  - `next_page_token` string — Token to access the next page. Absent if the current page is the last one.
  - `previous_page_token` string — Token to access the previous page. Absent if the current page is the first one.
  - `data` ListedProduct[], required — Page of products
    - `attributes` Attribute[], nullable — Additional product attributes
      - `id` string, required — Attribute's id
      - `name` string, required — Attribute's name
      - `type` string, required — The attribute's type Enum: `"STRING"`, `"NUMERIC"`, `"BOOLEAN"`
      - `value` object, required — The attribute's value
    - `brand` string, nullable — Brand
    - `category` Category — Category
      - `id` string, nullable — The id of the category
      - `labels` CategoryLabel[], required — Labels for the category with their associated locale
        - `locale` string, required — The language format can be ISO-639 or ISO-639_ISO-3166
        - `value` string, required — A label for the category
    - `descriptions` Description[], nullable — Descriptions with their associated locale
      - `locale` string, required — The language format can be ISO-639 or ISO-639_ISO-3166
      - `value` string, required — Description
    - `discount_prices` DiscountPrice[], nullable — Discount prices
      - `end_date` string, datetime, nullable — The end date of the discount interval in ISO 8601 format (UTC/Zulu time)
      - `price` Money, required
        - `amount` number, required — Price amount
        - `currency` string, iso-4217, required — Currency ISO code
      - `scope` string, nullable — Price scope
      - `start_date` string, datetime, nullable — The start date of the discount interval in ISO 8601 format (UTC/Zulu time)
    - `gtins` Gtin[] — GTIN (EAN, GENCOD, UPC, ISBN, etc.) used to map the product with one of the marketplace’s catalog
      - `value` string, required — GTIN value on 8, 12 or 13 digits
    - `id` string, required — Product identifier
    - `images` Image[], nullable — Images
      - `url` string, required — Image URL
    - `quantities` Quantity[] — Product quantities
      - `available_quantity` integer, required — Available quantity of a product
      - `warehouse_code` string — Warehouse code defined in your Mirakl account
    - `standard_prices` StandardPrice[] — Standard prices
      - `price` Money, required
        - `amount` number, required — Price amount
        - `currency` string, iso-4217, required — Currency ISO code
      - `scope` string, nullable — Price scope
    - `titles` Title[], nullable — Titles with their associated locale
      - `locale` string, required — The language format can be ISO-639 or ISO-639_ISO-3166
      - `value` string, required — Title
    - `partner_quantities` PartnerQuantity[] — Product quantities from partners
      - `available_quantity` integer, required — Available quantity of a product
      - `partner_id` string, required

---

[API](https://skmtc.net/mirakl/apis/mirakl-connect-apis.md) · [All operations](https://skmtc.net/mirakl/apis/mirakl-connect-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mirakl/mirakl-connect-apis/revisions/cc009fec5cdd/schema)