---
title: "Changes to List products"
method: GET
path: "/api/v1/products"
---

# Changes to List products

`GET /api/v1/products`

> Every recorded change to this operation, newest first.
> 110 revisions in range; 1 not diffed.

## Timeline

Changed in 18 of 110 revisions.

- **2026-05-06** `89876e7e51d6`: 1 info
- **2026-04-20** `69a36036d334`: 1 info
- **2025-10-10** `f36c4f94ae7b`: 3 info
- **2024-06-06** `8e82a2bd77e0`: 2 breaking, 33 info
- **2024-06-05** `e61df65649e2`: 2 breaking, 33 warning
- **2024-03-07** `71171a40d629`: 6 breaking, 40 info
- **2024-02-18** `88bbc1f38ff7`: 6 breaking, 41 warning
- **2024-02-10** `4ad0fff44c6c`: 2 breaking, 5 info
- **2024-01-24** `9dab078a46b5`: 1 info
- **2024-01-20** `70cd94370516`: 1 breaking
- **2023-07-08** `627936439128`: 5 breaking, 31 warning, 2 info
- **2023-04-29** `54497b7aa120`: 1 breaking, 2 info
- **2023-04-29** `53a4b63375d5`: 6 breaking, 8 info
- **2023-04-29** `acf2fffd6826`: 1 info
- **2023-03-19** `6890681c8503`: 29 info
- **2023-02-18** `30d5657591c5`: 7 info
- **2023-02-18** `1f82e271f76c`: 2 info
- **2023-02-18** `0334eb7cf0ab`: 1 info

## Changes

- **2026-05-06** `89876e7e51d6`: 1 info
  - for the `query` request parameter `sort`, the type was generalized from `string` to `array`
- **2026-04-20** `69a36036d334`: 1 info
  - added the optional property `data/items/income_account_id` to the response with the `200` status
- **2025-10-10** `f36c4f94ae7b`: 3 info
  - added the new optional `query` request parameter `index`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `per_page`
- **2024-06-06** `8e82a2bd77e0`: 2 breaking, 33 info
  - the response's body type changed from no type to `object` for status `default`
  - the `data/items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `code` to the response with the `default` status
  - added the optional property `data/items/archived_at` to the response with the `200` status
  - added the optional property `data/items/assigned_user_id` to the response with the `200` status
  - added the optional property `data/items/cost` to the response with the `200` status
  - added the optional property `data/items/created_at` to the response with the `200` status
  - added the optional property `data/items/custom_value1` to the response with the `200` status
  - added the optional property `data/items/custom_value2` to the response with the `200` status
  - added the optional property `data/items/custom_value3` to the response with the `200` status
  - added the optional property `data/items/custom_value4` to the response with the `200` status
  - added the optional property `data/items/id` to the response with the `200` status
  - added the optional property `data/items/in_stock_quantity` to the response with the `200` status
  - added the optional property `data/items/is_deleted` to the response with the `200` status
  - added the optional property `data/items/max_quantity` to the response with the `200` status
  - added the optional property `data/items/notes` to the response with the `200` status
  - added the optional property `data/items/price` to the response with the `200` status
  - added the optional property `data/items/product_image` to the response with the `200` status
  - added the optional property `data/items/product_key` to the response with the `200` status
  - added the optional property `data/items/project_id` to the response with the `200` status
  - added the optional property `data/items/quantity` to the response with the `200` status
  - added the optional property `data/items/stock_notification` to the response with the `200` status
  - added the optional property `data/items/stock_notification_threshold` to the response with the `200` status
  - added the optional property `data/items/tax_id` to the response with the `200` status
  - added the optional property `data/items/tax_name1` to the response with the `200` status
  - added the optional property `data/items/tax_name2` to the response with the `200` status
  - added the optional property `data/items/tax_name3` to the response with the `200` status
  - added the optional property `data/items/tax_rate1` to the response with the `200` status
  - added the optional property `data/items/tax_rate2` to the response with the `200` status
  - added the optional property `data/items/tax_rate3` to the response with the `200` status
  - added the optional property `data/items/updated_at` to the response with the `200` status
  - added the optional property `data/items/user_id` to the response with the `200` status
  - added the optional property `data/items/vendor_id` to the response with the `200` status
  - added the optional property `message` to the response with the `default` status
  - added the optional property `meta/pagination` to the response with the `200` status
- **2024-06-05** `e61df65649e2`: 2 breaking, 33 warning
  - the response's body type changed from `object` to no type for status `default`
  - the `data/items/` response's property type changed from `object` to no type for status `200`
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `data/items/archived_at` from the response with the `200` status
  - removed the optional property `data/items/assigned_user_id` from the response with the `200` status
  - removed the optional property `data/items/cost` from the response with the `200` status
  - removed the optional property `data/items/created_at` from the response with the `200` status
  - removed the optional property `data/items/custom_value1` from the response with the `200` status
  - removed the optional property `data/items/custom_value2` from the response with the `200` status
  - removed the optional property `data/items/custom_value3` from the response with the `200` status
  - removed the optional property `data/items/custom_value4` from the response with the `200` status
  - removed the optional property `data/items/id` from the response with the `200` status
  - removed the optional property `data/items/in_stock_quantity` from the response with the `200` status
  - removed the optional property `data/items/is_deleted` from the response with the `200` status
  - removed the optional property `data/items/max_quantity` from the response with the `200` status
  - removed the optional property `data/items/notes` from the response with the `200` status
  - removed the optional property `data/items/price` from the response with the `200` status
  - removed the optional property `data/items/product_image` from the response with the `200` status
  - removed the optional property `data/items/product_key` from the response with the `200` status
  - removed the optional property `data/items/project_id` from the response with the `200` status
  - removed the optional property `data/items/quantity` from the response with the `200` status
  - removed the optional property `data/items/stock_notification` from the response with the `200` status
  - removed the optional property `data/items/stock_notification_threshold` from the response with the `200` status
  - removed the optional property `data/items/tax_id` from the response with the `200` status
  - removed the optional property `data/items/tax_name1` from the response with the `200` status
  - removed the optional property `data/items/tax_name2` from the response with the `200` status
  - removed the optional property `data/items/tax_name3` from the response with the `200` status
  - removed the optional property `data/items/tax_rate1` from the response with the `200` status
  - removed the optional property `data/items/tax_rate2` from the response with the `200` status
  - removed the optional property `data/items/tax_rate3` from the response with the `200` status
  - removed the optional property `data/items/updated_at` from the response with the `200` status
  - removed the optional property `data/items/user_id` from the response with the `200` status
  - removed the optional property `data/items/vendor_id` from the response with the `200` status
  - removed the optional property `message` from the response with the `default` status
  - removed the optional property `meta/pagination` from the response with the `200` status
- **2024-03-07** `71171a40d629`: 6 breaking, 40 info
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `422`
  - the response's body type changed from no type to `object` for status `429`
  - the response's body type changed from no type to `object` for status `default`
  - the `data/items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `code` to the response with the `default` status
  - added the optional property `data/items/archived_at` to the response with the `200` status
  - added the optional property `data/items/assigned_user_id` to the response with the `200` status
  - added the optional property `data/items/cost` to the response with the `200` status
  - added the optional property `data/items/created_at` to the response with the `200` status
  - added the optional property `data/items/custom_value1` to the response with the `200` status
  - added the optional property `data/items/custom_value2` to the response with the `200` status
  - added the optional property `data/items/custom_value3` to the response with the `200` status
  - added the optional property `data/items/custom_value4` to the response with the `200` status
  - added the optional property `data/items/id` to the response with the `200` status
  - added the optional property `data/items/in_stock_quantity` to the response with the `200` status
  - added the optional property `data/items/is_deleted` to the response with the `200` status
  - added the optional property `data/items/max_quantity` to the response with the `200` status
  - added the optional property `data/items/notes` to the response with the `200` status
  - added the optional property `data/items/price` to the response with the `200` status
  - added the optional property `data/items/product_image` to the response with the `200` status
  - added the optional property `data/items/product_key` to the response with the `200` status
  - added the optional property `data/items/project_id` to the response with the `200` status
  - added the optional property `data/items/quantity` to the response with the `200` status
  - added the optional property `data/items/stock_notification` to the response with the `200` status
  - added the optional property `data/items/stock_notification_threshold` to the response with the `200` status
  - added the optional property `data/items/tax_id` to the response with the `200` status
  - added the optional property `data/items/tax_name1` to the response with the `200` status
  - added the optional property `data/items/tax_name2` to the response with the `200` status
  - added the optional property `data/items/tax_name3` to the response with the `200` status
  - added the optional property `data/items/tax_rate1` to the response with the `200` status
  - added the optional property `data/items/tax_rate2` to the response with the `200` status
  - added the optional property `data/items/tax_rate3` to the response with the `200` status
  - added the optional property `data/items/updated_at` to the response with the `200` status
  - added the optional property `data/items/user_id` to the response with the `200` status
  - added the optional property `data/items/vendor_id` to the response with the `200` status
  - added the optional property `errors` to the response with the `403` status
  - added the optional property `errors` to the response with the `422` status
  - added the optional property `errors` to the response with the `429` status
  - …6 more
- **2024-02-18** `88bbc1f38ff7`: 6 breaking, 41 warning
  - the response's body type changed from `object` to no type for status `401`
  - the response's body type changed from `object` to no type for status `403`
  - the response's body type changed from `object` to no type for status `422`
  - the response's body type changed from `object` to no type for status `429`
  - the response's body type changed from `object` to no type for status `default`
  - the `data/items/` response's property type changed from `object` to no type for status `200`
  - removed the optional property `code` from the response with the `default` status
  - removed the optional property `data/items/archived_at` from the response with the `200` status
  - removed the optional property `data/items/assigned_user_id` from the response with the `200` status
  - removed the optional property `data/items/company_id` from the response with the `200` status
  - removed the optional property `data/items/cost` from the response with the `200` status
  - removed the optional property `data/items/created_at` from the response with the `200` status
  - removed the optional property `data/items/custom_value1` from the response with the `200` status
  - removed the optional property `data/items/custom_value2` from the response with the `200` status
  - removed the optional property `data/items/custom_value3` from the response with the `200` status
  - removed the optional property `data/items/custom_value4` from the response with the `200` status
  - removed the optional property `data/items/id` from the response with the `200` status
  - removed the optional property `data/items/in_stock_quantity` from the response with the `200` status
  - removed the optional property `data/items/is_deleted` from the response with the `200` status
  - removed the optional property `data/items/max_quantity` from the response with the `200` status
  - removed the optional property `data/items/notes` from the response with the `200` status
  - removed the optional property `data/items/price` from the response with the `200` status
  - removed the optional property `data/items/product_image` from the response with the `200` status
  - removed the optional property `data/items/product_key` from the response with the `200` status
  - removed the optional property `data/items/project_id` from the response with the `200` status
  - removed the optional property `data/items/quantity` from the response with the `200` status
  - removed the optional property `data/items/stock_notification` from the response with the `200` status
  - removed the optional property `data/items/stock_notification_threshold` from the response with the `200` status
  - removed the optional property `data/items/tax_id` from the response with the `200` status
  - removed the optional property `data/items/tax_name1` from the response with the `200` status
  - removed the optional property `data/items/tax_name2` from the response with the `200` status
  - removed the optional property `data/items/tax_name3` from the response with the `200` status
  - removed the optional property `data/items/tax_rate1` from the response with the `200` status
  - removed the optional property `data/items/tax_rate2` from the response with the `200` status
  - removed the optional property `data/items/tax_rate3` from the response with the `200` status
  - removed the optional property `data/items/updated_at` from the response with the `200` status
  - removed the optional property `data/items/user_id` from the response with the `200` status
  - removed the optional property `data/items/vendor_id` from the response with the `200` status
  - removed the optional property `errors` from the response with the `403` status
  - removed the optional property `errors` from the response with the `422` status
  - …7 more
- **2024-02-10** `4ad0fff44c6c`: 2 breaking, 5 info
  - for the `query` request parameter `is_deleted`, the type changed from `booleans` to `boolean`
  - the `meta/pagination/links` response's property type changed from `array` to `object` for status `200`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `422`
  - added the media type `application/json` for the response with the status `429`
  - added the media type `application/json` for the response with the status `default`
- **2024-01-24** `9dab078a46b5`: 1 info
  - endpoint added
- **2024-01-20** `70cd94370516`: 1 breaking
  - api path removed without deprecation
- **2023-07-08** `627936439128`: 5 breaking, 31 warning, 2 info
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `403`
  - removed the media type `application/json` for the response with the status `422`
  - removed the media type `application/json` for the response with the status `429`
  - removed the media type `application/json` for the response with the status `default`
  - removed the optional property `archived_at` from the response with the `200` status
  - removed the optional property `assigned_user_id` from the response with the `200` status
  - removed the optional property `company_id` from the response with the `200` status
  - removed the optional property `cost` from the response with the `200` status
  - removed the optional property `created_at` from the response with the `200` status
  - removed the optional property `custom_value1` from the response with the `200` status
  - removed the optional property `custom_value2` from the response with the `200` status
  - removed the optional property `custom_value3` from the response with the `200` status
  - removed the optional property `custom_value4` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `in_stock_quantity` from the response with the `200` status
  - removed the optional property `is_deleted` from the response with the `200` status
  - removed the optional property `max_quantity` from the response with the `200` status
  - removed the optional property `notes` from the response with the `200` status
  - removed the optional property `price` from the response with the `200` status
  - removed the optional property `product_image` from the response with the `200` status
  - removed the optional property `product_key` from the response with the `200` status
  - removed the optional property `project_id` from the response with the `200` status
  - removed the optional property `quantity` from the response with the `200` status
  - removed the optional property `stock_notification` from the response with the `200` status
  - removed the optional property `stock_notification_threshold` from the response with the `200` status
  - removed the optional property `tax_id` from the response with the `200` status
  - removed the optional property `tax_name1` from the response with the `200` status
  - removed the optional property `tax_name2` from the response with the `200` status
  - removed the optional property `tax_name3` from the response with the `200` status
  - removed the optional property `tax_rate1` from the response with the `200` status
  - removed the optional property `tax_rate2` from the response with the `200` status
  - removed the optional property `tax_rate3` from the response with the `200` status
  - removed the optional property `updated_at` from the response with the `200` status
  - removed the optional property `user_id` from the response with the `200` status
  - removed the optional property `vendor_id` from the response with the `200` status
  - added the optional property `data` to the response with the `200` status
  - added the optional property `meta` to the response with the `200` status
- **2023-04-29** `54497b7aa120`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `429`
  - added the optional property `errors` to the response with the `429` status
  - added the optional property `message` to the response with the `429` status
- **2023-04-29** `53a4b63375d5`: 6 breaking, 8 info
  - the `cost` response's property format changed from `float` to `double` for status `200`
  - the `price` response's property format changed from `float` to `double` for status `200`
  - the `quantity` response's property format changed from `float` to `double` for status `200`
  - the `tax_rate1` response's property format changed from `float` to `double` for status `200`
  - the `tax_rate2` response's property format changed from `float` to `double` for status `200`
  - the `tax_rate3` response's property format changed from `float` to `double` for status `200`
  - added the optional property `tax_id` to the response with the `200` status
  - the response optional property `archived_at` became read-only for the status `200`
  - the response optional property `company_id` became read-only for the status `200`
  - the response optional property `created_at` became read-only for the status `200`
  - the response optional property `id` became read-only for the status `200`
  - the response optional property `is_deleted` became read-only for the status `200`
  - the response optional property `updated_at` became read-only for the status `200`
  - the response optional property `user_id` became read-only for the status `200`
- **2023-04-29** `acf2fffd6826`: 1 info
  - added the non-success response with the status `429`
- **2023-03-19** `6890681c8503`: 29 info
  - added the optional property `archived_at` to the response with the `200` status
  - added the optional property `assigned_user_id` to the response with the `200` status
  - added the optional property `company_id` to the response with the `200` status
  - added the optional property `cost` to the response with the `200` status
  - added the optional property `created_at` to the response with the `200` status
  - added the optional property `custom_value1` to the response with the `200` status
  - added the optional property `custom_value2` to the response with the `200` status
  - added the optional property `custom_value3` to the response with the `200` status
  - added the optional property `custom_value4` to the response with the `200` status
  - added the optional property `in_stock_quantity` to the response with the `200` status
  - added the optional property `is_deleted` to the response with the `200` status
  - added the optional property `max_quantity` to the response with the `200` status
  - added the optional property `notes` to the response with the `200` status
  - added the optional property `price` to the response with the `200` status
  - added the optional property `product_image` to the response with the `200` status
  - added the optional property `product_key` to the response with the `200` status
  - added the optional property `project_id` to the response with the `200` status
  - added the optional property `quantity` to the response with the `200` status
  - added the optional property `stock_notification` to the response with the `200` status
  - added the optional property `stock_notification_threshold` to the response with the `200` status
  - added the optional property `tax_name1` to the response with the `200` status
  - added the optional property `tax_name2` to the response with the `200` status
  - added the optional property `tax_name3` to the response with the `200` status
  - added the optional property `tax_rate1` to the response with the `200` status
  - added the optional property `tax_rate2` to the response with the `200` status
  - added the optional property `tax_rate3` to the response with the `200` status
  - added the optional property `updated_at` to the response with the `200` status
  - added the optional property `user_id` to the response with the `200` status
  - added the optional property `vendor_id` to the response with the `200` status
- **2023-02-18** `30d5657591c5`: 7 info
  - added the new optional `query` request parameter `client_id`
  - added the new optional `query` request parameter `created_at`
  - added the new optional `query` request parameter `filter_deleted_clients`
  - added the new optional `query` request parameter `is_deleted`
  - added the new optional `query` request parameter `status`
  - added the new optional `query` request parameter `updated_at`
  - added the new optional `query` request parameter `vendor_id`
- **2023-02-18** `1f82e271f76c`: 2 info
  - added the new optional `query` request parameter `product_key`
  - added the new optional `query` request parameter `sort`
- **2023-02-18** `0334eb7cf0ab`: 1 info
  - added the new optional `query` request parameter `filter`

---

[Operation](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/docs/api/v1/products/get.md) - [API](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference.md) - [Page](https://skmtc.dev/invoiceninja/apis/invoice-ninja-api-reference/changes/api/v1/products/get)
