---
updatedAt: 2026-10-29T11:54:48.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Retrieve products

Retrieves a list of all of your store's products. You can use this endpoint to resolve the Yotpo product ID in order to update it.

> 👍 How to use this endpoint
>
> * Required parameters are listed below. For the full list of properties, see [About products](https://docs.yotpo.com/reference/products).
> * For example responses, click the relevant status code on the right.
> * Each page returns up to `limit` products (1 to 100, default 100). To get the next page, send the `pagination.next_page_info` value from the response as `page_info`.

## Example requests

```http Get first page
GET /core/v3/stores/{store_id}/products
```
```http Get following pages
GET /core/v3/stores/{store_id}/products?page_info={page_info}
```
```http Pagination with limit
GET /core/v3/stores/{store_id}/products?page_info={page_info}&limit={limit}
```
```http Get with external_ids filter
GET /core/v3/stores/{store_id}/products?external_ids=ext1,ext2
```

> 📘 App partners
>
> Partner apps call this endpoint at `GET https://developers.yotpo.com/core/v3/stores/{store_id}/products`, with the access token the merchant's install gave you in the `X-Yotpo-Token` header. See [Authenticating with OAuth 2.0](https://docs.yotpo.com/docs/authenticating).

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Yotpo API V3",
    "description": "Yotpo API V3 endpoints on api.yotpo.com. Webhook events are defined separately, in webhooks.json.",
    "version": "3.0"
  },
  "servers": [
    {
      "url": "https://api.yotpo.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "X-Yotpo-Token": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Yotpo-Token",
        "description": "Your Yotpo account access token. See [Authentication](https://core-api.yotpo.com/reference/yotpo-authentication) to learn how to generate your access token."
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Unauthorized. The access token is missing, invalid or expired. With an invalid or expired `X-Yotpo-Token` the body is plain text: generate a new token with [Generate access token](ref:yotpo-authentication). A request with an `Authorization` header and no `X-Yotpo-Token` gets `Bad token; invalid JSON` as JSON: send the token in `X-Yotpo-Token`. An `Authorization` header sent along with a valid `X-Yotpo-Token` is ignored.",
        "content": {
          "text/plain": {
            "schema": {
              "type": "string",
              "example": "unauthorized"
            }
          },
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "description": "Error message.",
                  "example": "Bad token; invalid JSON"
                }
              }
            },
            "examples": {
              "Authorization header without X-Yotpo-Token": {
                "value": "{\n  \"message\": \"Bad token; invalid JSON\"\n}"
              }
            }
          }
        }
      },
      "Forbidden": {
        "description": "Forbidden. The request has no `X-Yotpo-Token` header.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "message": {
                  "type": "string",
                  "description": "Error message.",
                  "example": "Forbidden"
                }
              }
            },
            "examples": {
              "Missing token": {
                "value": "{\n  \"message\": \"Forbidden\"\n}"
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "X-Yotpo-Token": []
    }
  ],
  "paths": {
    "/core/v3/stores/{store_id}/products": {
      "get": {
        "summary": "Retrieve products",
        "description": "Retrieves a list of all of your store's products. You can use this endpoint to resolve the Yotpo product ID in order to update it.",
        "operationId": "retrieve-products",
        "parameters": [
          {
            "name": "store_id",
            "in": "path",
            "description": "The store ID (app_key).",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "page_info",
            "in": "query",
            "description": "Encoded page info.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The number of results per page, from 1 to 100. Defaults to 100.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 100,
              "minimum": 1,
              "maximum": 100
            },
            "example": 100
          },
          {
            "name": "external_ids",
            "in": "query",
            "description": "Return only entities specified by a comma-separated (without spaces) list of external IDs. The argument must be <a href=\"https://www.urlencoder.io/learn\" target=\"_blank\">URL encoded</a>. Max 100 IDs. Can't come with page_info or limit.",
            "schema": {
              "type": "string"
            },
            "example": "23234"
          },
          {
            "name": "handles",
            "in": "query",
            "description": "Return only products with these handles, as a comma-separated list (no spaces). Can't be combined with `page_info` or `limit`.",
            "schema": {
              "type": "string"
            },
            "example": "minimal-surfboard"
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "By external IDs": {
                    "value": "{\n  \"products\": [\n    {\n      \"yotpo_id\": 12345,\n      \"external_id\": \"ex001\",\n      \"name\": \"minimal surfboard\",\n      \"description\": \"A great surfboard!\",\n      \"status\": \"active\",\n      \"url\": \"http://www.waverider.com/products/minimalsurfboard\",\n      \"is_valid_url_format\": true,\n      \"image_url\": \"http://www.waverider.com/products/minimalsurfboard/images/1.jpg\",\n      \"price\": 750,\n      \"compare_at_price\": 800,\n      \"currency\": \"USD\",\n      \"inventory_quantity\": 10,\n      \"is_discontinued\": false,\n      \"group_name\": \"surfboards\",\n      \"brand\": \"Waverider\",\n      \"sku\": \"xxxxx\",\n      \"mpn\": \"xxxxx\",\n      \"gtins\": [\n        {\n          \"declared_type\": \"UPC\",\n          \"value\": \"742833102466\"\n        },\n        {\n          \"value\": \"5057913274083\"\n        }\n      ],\n      \"custom_properties\": {\n        \"is_blocklisted\": true,\n        \"review_form_tag\": \"surfboard\"\n      },\n      \"created_at\": \"2020-09-08T08:43:27Z\",\n      \"updated_at\": \"2020-10-08T08:43:27Z\",\n      \"store_id\": \"YOUR_STORE_ID\"\n    },\n    {\n      \"yotpo_id\": 67890,\n      \"external_id\": \"ex002\",\n      \"name\": \"longboard surfboard\",\n      \"description\": \"Always catches the best waves!\",\n      \"url\": \"http://www.waverider.com/products/longboard\",\n      \"is_valid_url_format\": false,\n      \"image_url\": \"http://www.waverider.com/products/longboard/images/1.jpg\",\n      \"price\": 9001,\n      \"currency\": \"USD\",\n      \"inventory_quantity\": 0,\n      \"is_discontinued\": true,\n      \"group_name\": \"longboards\",\n      \"brand\": \"Waverider\",\n      \"sku\": \"xxxxx\",\n      \"mpn\": \"xxxxx\",\n      \"gtins\": [\n        {\n          \"declared_type\": \"UPC\",\n          \"value\": \"742833102466\"\n        },\n        {\n          \"value\": \"5057913274083\"\n        }\n      ],\n      \"custom_properties\": {\n        \"is_blocklisted\": true,\n        \"review_form_tag\": \"surfboard\"\n      },\n      \"created_at\": \"2020-09-08T08:43:27Z\",\n      \"updated_at\": \"2020-10-08T08:43:27Z\",\n      \"store_id\": \"YOUR_STORE_ID\"\n    }\n  ],\n  \"pagination\": {\n    \"next_page_info\": null\n  }\n}"
                  },
                  "Pagination": {
                    "value": "{\n  \"products\": [\n    {\n      \"yotpo_id\": 12345,\n      \"external_id\": \"ex001\",\n      \"name\": \"minimal surfboard\",\n      \"description\": \"A great surfboard!\",\n      \"status\": \"active\",\n      \"url\": \"http://www.waverider.com/products/minimalsurfboard\",\n      \"is_valid_url_format\": true,\n      \"image_url\": \"http://www.waverider.com/products/minimalsurfboard/images/1.jpg\",\n      \"price\": 750,\n      \"compare_at_price\": 800,\n      \"currency\": \"USD\",\n      \"inventory_quantity\": 10,\n      \"is_discontinued\": false,\n      \"group_name\": \"surfboards\",\n      \"brand\": \"Waverider\",\n      \"sku\": \"xxxxx\",\n      \"mpn\": \"xxxxx\",\n      \"gtins\": [\n        {\n          \"declared_type\": \"UPC\",\n          \"value\": \"742833102466\"\n        },\n        {\n          \"value\": \"5057913274083\"\n        }\n      ],\n      \"custom_properties\": {\n        \"is_blocklisted\": true,\n        \"review_form_tag\": \"surfboard\"\n      },\n      \"created_at\": \"2020-09-08T08:43:27Z\",\n      \"updated_at\": \"2020-10-08T08:43:27Z\",\n      \"store_id\": \"YOUR_STORE_ID\"\n    },\n    {\n      \"yotpo_id\": 67890,\n      \"external_id\": \"ex002\",\n      \"name\": \"longboard surfboard\",\n      \"description\": \"Always catches the best waves!\",\n      \"url\": \"http://www.waverider.com/products/longboard\",\n      \"is_valid_url_format\": false,\n      \"image_url\": \"http://www.waverider.com/products/longboard/images/1.jpg\",\n      \"price\": 900,\n      \"currency\": \"USD\",\n      \"inventory_quantity\": 0,\n      \"is_discontinued\": true,\n      \"group_name\": \"longboards\",\n      \"brand\": \"Waverider\",\n      \"sku\": \"xxxxx\",\n      \"mpn\": \"xxxxx\",\n      \"gtins\": [\n        {\n          \"declared_type\": \"UPC\",\n          \"value\": \"742833102466\"\n        },\n        {\n          \"value\": \"5057913274083\"\n        }\n      ],\n      \"custom_properties\": {\n        \"is_blocklisted\": true,\n        \"review_form_tag\": \"surfboard\"\n      },\n      \"created_at\": \"2020-09-08T08:43:27Z\",\n      \"updated_at\": \"2020-10-08T08:43:27Z\",\n      \"store_id\": \"YOUR_STORE_ID\"\n    }\n  ],\n  \"pagination\": {\n    \"next_page_info\": \"eyJjdXJzb3IiOjE4ODgwNzE2NSwiZmlsdGVyIjpbeyJuYW1lIjoic3RvcmVJZCIsImRhdGVfdHlwZSI6IlNUUklORyIsInZhbHVlIjoiQWd4eGhiRENyTFZZQUg4cDZEN1Z5MGNPRjZmcENacm45UUlrU2hKNyJ9XX0=\"\n  }\n}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "title": "By external IDs",
                      "type": "object",
                      "properties": {
                        "products": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "yotpo_id": {
                                "type": "integer",
                                "example": 12345,
                                "default": 0,
                                "description": "The Yotpo ID of the product. Use it as `yotpo_product_id` in product, variant and collection paths."
                              },
                              "external_id": {
                                "type": "string",
                                "example": "ex001",
                                "description": "The product ID in your store."
                              },
                              "name": {
                                "type": "string",
                                "example": "minimal surfboard",
                                "description": "The product name."
                              },
                              "description": {
                                "type": "string",
                                "example": "A great surfboard!",
                                "description": "The product description. Omitted when not set."
                              },
                              "status": {
                                "type": "string",
                                "example": "active",
                                "description": "The product status: `active`, `draft`, `archived` or `inactive`. Omitted when not set."
                              },
                              "url": {
                                "type": "string",
                                "example": "http://www.waverider.com/products/minimalsurfboard",
                                "description": "The product page URL in your store. Omitted when not set."
                              },
                              "is_valid_url_format": {
                                "type": "boolean",
                                "example": true,
                                "default": true,
                                "description": "Whether `url` is a well-formed URL."
                              },
                              "image_url": {
                                "type": "string",
                                "example": "http://www.waverider.com/products/minimalsurfboard/images/1.jpg",
                                "description": "The product image URL. Omitted when not set."
                              },
                              "price": {
                                "type": "number",
                                "example": 750,
                                "description": "The product price, in `currency`."
                              },
                              "compare_at_price": {
                                "type": "number",
                                "example": 800,
                                "description": "The original price before a sale or adjustment. Omitted when not set."
                              },
                              "currency": {
                                "type": "string",
                                "example": "USD",
                                "description": "The three-letter ISO currency code of `price`, for example `USD`. Omitted when not set."
                              },
                              "inventory_quantity": {
                                "type": "integer",
                                "example": 10,
                                "default": 0,
                                "description": "The number of items in stock. Omitted when not set."
                              },
                              "is_discontinued": {
                                "type": "boolean",
                                "example": false,
                                "default": true,
                                "description": "Whether the product is discontinued. Discontinued products are added to the blocklist automatically."
                              },
                              "group_name": {
                                "type": "string",
                                "example": "surfboards",
                                "description": "The product group. Products in the same group share reviews. Omitted when the product isn't in a group."
                              },
                              "brand": {
                                "type": "string",
                                "example": "Waverider",
                                "description": "The product brand. Omitted when not set."
                              },
                              "sku": {
                                "type": "string",
                                "example": "xxxxx",
                                "description": "The product SKU. Omitted when not set."
                              },
                              "mpn": {
                                "type": "string",
                                "example": "xxxxx",
                                "description": "The Manufacturer Part Number. Omitted when not set."
                              },
                              "gtins": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "declared_type": {
                                      "type": "string",
                                      "example": "UPC",
                                      "description": "The barcode standard: `EAN`, `UPC` or `ISBN`."
                                    },
                                    "value": {
                                      "type": "string",
                                      "example": "742833102466",
                                      "description": "The barcode value."
                                    }
                                  }
                                },
                                "description": "The product barcodes (GTINs). Empty when none are set."
                              },
                              "custom_properties": {
                                "type": "object",
                                "properties": {
                                  "is_blocklisted": {
                                    "type": "boolean",
                                    "example": true,
                                    "default": true,
                                    "description": "Whether the product is on the blocklist. Blocklisted products get no automatic review requests and don't appear in customer-facing widgets."
                                  },
                                  "review_form_tag": {
                                    "type": "string",
                                    "example": "surfboard",
                                    "description": "The custom review form used for this product. Omitted when the default form is used."
                                  }
                                },
                                "description": "Additional product properties. Omitted when none are set."
                              },
                              "created_at": {
                                "type": "string",
                                "example": "2020-09-08T08:43:27Z",
                                "description": "When the product was created in Yotpo (UTC, ISO 8601 without a time zone suffix)."
                              },
                              "updated_at": {
                                "type": "string",
                                "example": "2020-10-08T08:43:27Z",
                                "description": "When the product was last updated in Yotpo (UTC, ISO 8601 without a time zone suffix)."
                              },
                              "store_id": {
                                "type": "string",
                                "description": "The store ID (app key) the product belongs to.",
                                "example": "YOUR_STORE_ID"
                              },
                              "group_id": {
                                "type": "integer",
                                "description": "The Yotpo ID of the product group, when the product has a `group_name`.",
                                "example": 56057006
                              },
                              "handle": {
                                "type": "string",
                                "description": "The product handle (URL slug) in your store.",
                                "example": "minimal-surfboard"
                              }
                            }
                          },
                          "description": "The products on this page."
                        },
                        "pagination": {
                          "type": "object",
                          "properties": {
                            "next_page_info": {
                              "description": "Not returned when you filter by `external_ids`: all matching results come in one response.",
                              "type": "string"
                            }
                          },
                          "description": "Pagination details. Empty on the last page."
                        }
                      }
                    },
                    {
                      "title": "Pagination",
                      "type": "object",
                      "properties": {
                        "products": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "yotpo_id": {
                                "type": "integer",
                                "example": 12345,
                                "default": 0,
                                "description": "The Yotpo ID of the product. Use it as `yotpo_product_id` in product, variant and collection paths."
                              },
                              "external_id": {
                                "type": "string",
                                "example": "ex001",
                                "description": "The product ID in your store."
                              },
                              "name": {
                                "type": "string",
                                "example": "minimal surfboard",
                                "description": "The product name."
                              },
                              "description": {
                                "type": "string",
                                "example": "A great surfboard!",
                                "description": "The product description. Omitted when not set."
                              },
                              "status": {
                                "type": "string",
                                "example": "active",
                                "description": "The product status: `active`, `draft`, `archived` or `inactive`. Omitted when not set."
                              },
                              "url": {
                                "type": "string",
                                "example": "http://www.waverider.com/products/minimalsurfboard",
                                "description": "The product page URL in your store. Omitted when not set."
                              },
                              "is_valid_url_format": {
                                "type": "boolean",
                                "example": true,
                                "default": true,
                                "description": "Whether `url` is a well-formed URL."
                              },
                              "image_url": {
                                "type": "string",
                                "example": "http://www.waverider.com/products/minimalsurfboard/images/1.jpg",
                                "description": "The product image URL. Omitted when not set."
                              },
                              "price": {
                                "type": "number",
                                "example": 750,
                                "description": "The product price, in `currency`."
                              },
                              "compare_at_price": {
                                "type": "number",
                                "example": 800,
                                "description": "The original price before a sale or adjustment. Omitted when not set."
                              },
                              "currency": {
                                "type": "string",
                                "example": "USD",
                                "description": "The three-letter ISO currency code of `price`, for example `USD`. Omitted when not set."
                              },
                              "inventory_quantity": {
                                "type": "integer",
                                "example": 10,
                                "default": 0,
                                "description": "The number of items in stock. Omitted when not set."
                              },
                              "is_discontinued": {
                                "type": "boolean",
                                "example": false,
                                "default": true,
                                "description": "Whether the product is discontinued. Discontinued products are added to the blocklist automatically."
                              },
                              "group_name": {
                                "type": "string",
                                "example": "surfboards",
                                "description": "The product group. Products in the same group share reviews. Omitted when the product isn't in a group."
                              },
                              "brand": {
                                "type": "string",
                                "example": "Waverider",
                                "description": "The product brand. Omitted when not set."
                              },
                              "sku": {
                                "type": "string",
                                "example": "xxxxx",
                                "description": "The product SKU. Omitted when not set."
                              },
                              "mpn": {
                                "type": "string",
                                "example": "xxxxx",
                                "description": "The Manufacturer Part Number. Omitted when not set."
                              },
                              "gtins": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "declared_type": {
                                      "type": "string",
                                      "example": "UPC",
                                      "description": "The barcode standard: `EAN`, `UPC` or `ISBN`."
                                    },
                                    "value": {
                                      "type": "string",
                                      "example": "742833102466",
                                      "description": "The barcode value."
                                    }
                                  }
                                },
                                "description": "The product barcodes (GTINs). Empty when none are set."
                              },
                              "custom_properties": {
                                "type": "object",
                                "properties": {
                                  "is_blocklisted": {
                                    "type": "boolean",
                                    "example": true,
                                    "default": true,
                                    "description": "Whether the product is on the blocklist. Blocklisted products get no automatic review requests and don't appear in customer-facing widgets."
                                  },
                                  "review_form_tag": {
                                    "type": "string",
                                    "example": "surfboard",
                                    "description": "The custom review form used for this product. Omitted when the default form is used."
                                  }
                                },
                                "description": "Additional product properties. Omitted when none are set."
                              },
                              "created_at": {
                                "type": "string",
                                "example": "2020-09-08T08:43:27Z",
                                "description": "When the product was created in Yotpo (UTC, ISO 8601 without a time zone suffix)."
                              },
                              "updated_at": {
                                "type": "string",
                                "example": "2020-10-08T08:43:27Z",
                                "description": "When the product was last updated in Yotpo (UTC, ISO 8601 without a time zone suffix)."
                              },
                              "store_id": {
                                "type": "string",
                                "description": "The store ID (app key) the product belongs to.",
                                "example": "YOUR_STORE_ID"
                              },
                              "group_id": {
                                "type": "integer",
                                "description": "The Yotpo ID of the product group, when the product has a `group_name`.",
                                "example": 56057006
                              },
                              "handle": {
                                "type": "string",
                                "description": "The product handle (URL slug) in your store.",
                                "example": "minimal-surfboard"
                              }
                            }
                          },
                          "description": "The products on this page."
                        },
                        "pagination": {
                          "type": "object",
                          "properties": {
                            "next_page_info": {
                              "type": "string",
                              "example": "eyJjdXJzb3IiOjE4ODgwNzE2NSwiZmlsdGVyIjpbeyJuYW1lIjoic3RvcmVJZCIsImRhdGVfdHlwZSI6IlNUUklORyIsInZhbHVlIjoiQWd4eGhiRENyTFZZQUg4cDZEN1Z5MGNPRjZmcENacm45UUlrU2hKNyJ9XX0=",
                              "description": "Pass this value as `page_info` to get the next page. Omitted on the last page."
                            }
                          },
                          "description": "Pagination details. Empty on the last page."
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"errors\": [\n    {\n      \"message\": \"page size cannot be bigger than the allowed maximum: 100\"\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "message": {
                            "type": "string",
                            "example": "page size cannot be bigger than the allowed maximum: 100",
                            "description": "What's wrong with the request, usually naming the missing or invalid field. Meant for logs; the wording can change, so don't parse it."
                          }
                        }
                      },
                      "description": "The validation errors. Usually one item."
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "value": "application/json",
        "key": "Content-Type"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```

# Sibling pages

* [About products](https://docs.yotpo.com/reference/products.md)
* [Create product](https://docs.yotpo.com/reference/create-product.md)
* [Update product](https://docs.yotpo.com/reference/update-product.md)
* [Retrieve product by ID](https://docs.yotpo.com/reference/retrieve-product-by-id.md)
* [About product variants](https://docs.yotpo.com/reference/product-variants.md)
* [Create product variant](https://docs.yotpo.com/reference/create-product-variant.md)
* [Update product variant](https://docs.yotpo.com/reference/update-product-variant.md)
* [Retrieve product variants](https://docs.yotpo.com/reference/retrieve-product-variants.md)
* [Retrieve product variant by ID](https://docs.yotpo.com/reference/retrieve-product-variant-by-id.md)
* [About collections](https://docs.yotpo.com/reference/collections.md)
* [Create collection](https://docs.yotpo.com/reference/create-collection.md)
* [Update collection](https://docs.yotpo.com/reference/update-collection.md)
* [Retrieve collections](https://docs.yotpo.com/reference/retrieve-collections.md)
* [Add product to collection](https://docs.yotpo.com/reference/add-product-to-collection.md)
* [Retrieve products in collection](https://docs.yotpo.com/reference/retrieve-products-in-collection.md)
* [Remove product from collection](https://docs.yotpo.com/reference/remove-product-from-collection.md)
* [Retrieve list of collections for product](https://docs.yotpo.com/reference/retrieve-list-of-collections-for-product.md)