# Breaking changes to product endpoint

**URL:** <https://forums.ordoro.com/t/breaking-changes-to-product-endpoint/435>\
**Category:** API Announcements\
**Tags:** breaking\_change\
**Created:** [July 30, 2019, 7:56pm UTC](https://forums.ordoro.com/t/breaking-changes-to-product-endpoint/435 "2019-07-30T19:56:43Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![syork](https://yyz1.discourse-cdn.com/flex029/user_avatar/forums.ordoro.com/syork/32/61_2.png) [@syork](https://forums.ordoro.com/u/syork)\
**Post date:** [July 30, 2019, 7:56pm UTC](https://forums.ordoro.com/t/breaking-changes-to-product-endpoint/435/1 "2019-07-30T19:56:43Z")

</div>

## Release Date

July 30, 2019

## Breaking Changes

We are changing the way our `GET /product/` endpoint behaves.

Previously, the endpoint accepted a `status` param with one of the following statuses:

```auto
kit_parent
kit_component
low_inventory
always_dropship
never_dropship
needs_sync
to_be_shipped
oversold
archived
active
all

Example: GET /product/?status=kit_parent

```

Once the new product filters feature is released for your account, the product endpoint will no longer acknowledge `status` as a param. Instead, it will now accept the following parameters:

```auto
active bool
kit bool
kit_component bool
dropship bool
needs_sync bool
low_inventory bool
to_be_shipped bool
oversold bool
supplier int (accepts multiple)
sales_channel int (accepts multiple)
category string (accepts multiple)

```

The `bool` parameters all accept both `true` and `false` and will NOT apply any filter if not supplied.  
For instance, to fetch ONLY active products, you will need to make the following request:  
`GET /product/?active=true`.

If the `active` param is not supplied, you will get all products, including `archived`.  
Inversely, if you want to fetch only archived products, send `?active=false`.

You can combine any number of params. For example, to fetch active kit components make the following request:  
`GET /product/?active=true&kit_component=true`

To fetch active NON kit components do the inverse:  
`GET /product/?active=true&kit_component=false`

Some params can be passed multiple times: `GET /product/?supplier=1&supplier=2`

## Other Changes

- The `limit`, `offset`, `sort`, and `search` params have not changed.
- `cart` is stilll accepted, however it is being deprecated in favor of `sales_channel`.
  - `sales_channel` will accept multiple inputs, whereas `cart` can only be passed once

## How do I know if I have this feature?

- If you have the new product list page with the `omnibar` at the top, then you can take advantage of these new filters. Until then, please continue to use the `status` param.

For more information please see the [Ordoro API documentation](https://ordoro.docs.apiary.io/#reference/product/product/get)