v1

latestOpenAPI 3.1.02026-07-24920300.7 KB

List

Returns a list of all merchant's products that are autoship enabled and not discontinued.

get/products/

Query parameters

searchstring

A single string value used to search for products. The value in this parameter will be matched against product’s name, sku, or external_product_id, depending on the field specified in the "fields" parameter. e.g. /products?search=12345&fields=sku

fieldsstring

Specifies which field (name, sku, or external_product_id) the "search" parameter value should be matched against. name – Matches the search value against the product’s name. sku – Matches the search value against the product’s SKU. external_product_id – Matches the search value against the product’s external product ID. e.g. /products?search=12345&fields=sku

id_or_namestring

Case insensitive partial match for Product ID or Name

autoship_enabledstring

By default the endpoint will only return products that are autoship enabled, but you can change the behavior by passing "all" to return all products regardless of their autoship status. You can also pass "false" to only return products that are NOT autoship enabled

allow_discontinuedstring

By default the endpoint returns non-discontinued products, but you can change the behavior by passing "true" to also include discontinued products. You can also pass "strict" to only list the discontinued products

group_namestring

Product group's name

group_typestring

Product group's type

autoship_by_defaultboolean
liveboolean

Account status: active = True

external_product_ids[]string

Product ID (could be passed multiple times in the query string to match multiple products). Note there is "[]" at the end of this field that is required

product_type'"standard"' | '"rotating"' | '"static price bundle"' | '"dynamic price bundle"'

Product Type

include_product_selection_rulesboolean

For rotating products this param returns a product_selection_rules list with all selection_list_elements

Response

200

countinteger
nextstring
{"stackTrail":"paths:/products/:get:responses:200:content:application/json:schema:properties:previous","oasType":"schema","type":"unknown"}

Example response

{
  "count": 1,
  "next": "https://restapi.ordergroove.com/products/?page=2",
  "results": [
    {
      "merchant": "519f1f120e3411ef984b1e8a267ce85a",
      "groups": [
        {
          "name": "subscription",
          "group_type": "eligibility"
        }
      ],
      "name": "Medium Roast Coffee Bag",
      "price": "10.00",
      "image_url": "image-url",
      "detail_url": "product-url",
      "external_product_id": "48398751432995",
      "sku": "48398751432995",
      "autoship_enabled": true,
      "created": "2024-05-09 15:20:09",
      "last_update": "2024-05-13 08:56:36",
      "live": true,
      "product_type": "standard",
      "autoship_by_default": true
    }
  ]
}