List Products

Prod Env

GET

/store/products

Retrieves a list of products. The products can be filtered by fields such as id or q. The products can also be sorted or paginated.
This API Route can also be used to retrieve a product by its handle.

For accurate and correct pricing of the products based on the customer's context, it's highly recommended to pass fields such as
region_id, currency_code, and cart_id when available.

Passing sales_channel_id ensures retrieving only products available in the specified sales channel.
You can alternatively use a publishable API key in the request header instead of passing a sales_channel_id.

Request Example

JavaScript

Shell

Java

Swift

curl --location -g --request GET '{{baseURL}}/store/products?q&id&date=&sales_channel_id&collection_id&type_id&tags&title&description&handle&is_giftcard&category_id&include_category_children&offset&limit&expand&fields&order&cart_id&lt=&lt=&gt=&gt=&lte=&lte=&gte=&gte=&region_id&currency_code'

Response Example

200 - Example 1

{
    "count": -20464045,
    "offset": -49598720,
    "limit": -11442105,
    "products": [
        {
            "id": "prod_01G1G5V2MBA328390B5AXJ610F",
            "title": "Medusa Coffee Mug",
            "subtitle": "chubby patiently communicate scared role",
            "description": "Every programmer's best friend.",
            "handle": "coffee-mug",
            "is_giftcard": false,
            "thumbnail": null,
            "profile_id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
            "weight": null,
            "length": null,
            "height": null,
            "width": null,
            "hs_code": null,
            "origin_country": null,
            "mid_code": null,
            "material": null,
            "collection_id": "pcol_01F0YESBFAZ0DV6V831JXWH0BG",
            "type_id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
            "discountable": true,
            "external_id": null,
            "created_at": "2025-06-05T21:15:52.679Z",
            "updated_at": "2024-12-25",
            "deleted_at": "2025-06-05T23:07:40.904Z",
            "status": "draft",
            "metadata": {
                "car": "white"
            },
            "categories": [
                {
                    "id": "pcat_01G2SG30J8C85S4A5CHM2S1NS2",
                    "name": "Regular Fit",
                    "description": "",
                    "handle": "regular-fit",
                    "mpath": "pcat_id1.pcat_id2.pcat_id3",
                    "is_internal": false,
                    "is_active": false,
                    "rank": 0,
                    "parent_category_id": null,
                    "parent_category": null,
                    "created_at": "2025-06-06T05:39:22.239Z",
                    "updated_at": "2024-06-07",
                    "category_children": [],
                    "products": [],
                    "metadata": {
                        "car": "white"
                    }
                },
                {
                    "id": "pcat_01G2SG30J8C85S4A5CHM2S1NS2",
                    "name": "Regular Fit",
                    "description": "",
                    "handle": "regular-fit",
                    "mpath": "pcat_id1.pcat_id2.pcat_id3",
                    "is_internal": false,
                    "is_active": false,
                    "rank": 0,
                    "parent_category_id": null,
                    "parent_category": {},
                    "created_at": "2025-06-05T15:32:46.076Z",
                    "updated_at": "2024-12-07",
                    "category_children": [],
                    "products": [],
                    "metadata": {
                        "car": "white"
                    }
                }
            ],
            "collection": {
                "id": "pcol_01F0YESBFAZ0DV6V831JXWH0BG",
                "title": "Summer Collection",
                "handle": "summer-collection",
                "created_at": "2025-06-06T08:14:18.824Z",
                "updated_at": "2025-12-27",
                "deleted_at": "2025-06-05T13:16:06.356Z",
                "products": [],
                "metadata": {
                    "car": "white"
                }
            },
            "type": {
                "id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
                "value": "Clothing",
                "created_at": "2025-06-06T00:37:39.225Z",
                "updated_at": "2024-08-04",
                "deleted_at": "2025-06-05T11:48:02.110Z",
                "metadata": {
                    "car": "white"
                }
            },
            "tags": [
                {
                    "id": "ptag_01G8K2MTMG9168F2B70S1TAVK3",
                    "value": "Pants",
                    "created_at": "2025-06-05T16:13:20.492Z",
                    "updated_at": "2024-08-03",
                    "deleted_at": "2025-06-05T14:24:24.706Z",
                    "metadata": {
                        "car": "white"
                    }
                },
                {
                    "id": "ptag_01G8K2MTMG9168F2B70S1TAVK3",
                    "value": "Pants",
                    "created_at": "2025-06-06T04:54:16.202Z",
                    "updated_at": "2026-02-01",
                    "deleted_at": "2025-06-05T12:38:18.671Z",
                    "metadata": {
                        "car": "white"
                    }
                },
                {
                    "id": "ptag_01G8K2MTMG9168F2B70S1TAVK3",
                    "value": "Pants",
                    "created_at": "2025-06-06T00:14:05.521Z",
                    "updated_at": "2026-04-08",
                    "deleted_at": "2025-06-05T18:16:39.321Z",
                    "metadata": {
                        "car": "white"
                    }
                }
            ],
            "images": [
                {
                    "id": "img_01G749BFYR6T8JTVW6SGW3K3E6",
                    "url": "https://imaginative-maintai

Request

Query Params

Responses

🟢200OK

application/json

Body

🟠400Client Error or Multiple Errors

🟠404Not Found Error

🟠409Invalid State Error

🟠422Invalid Request Error

🔴500Server Error

Modified at 2025-07-23 05:41:28

Get a Product

Get Product Variants