GET /products

Retrieve a paginated list of all ecommerce products stored in your Brevo account. Results are sorted by creation date in descending order by default, and can be filtered by product IDs, name (minimum 3 characters), price range, category IDs, modification date, creation date, or deletion status. Use the search parameter to query across SKU, name, and ID simultaneously — results are prioritized as exact SKU match > SKU prefix match > name match > ID match. Pagination defaults to 50 products per page (maximum 1000), and the response includes a count field with the total number of matching products.

Servers

Query parameters

Name Type Required Description
modifiedSince String No

Filter (urlencoded) the products modified after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.

alternativePrice[ne] Number No

Alternative price filter for products not equals to particular amount

sort String No

Sort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

Valid values:

  • "desc"
  • "asc"

Default value: "desc"

search String No

Search products simultaneously across SKU, name, and ID fields. Results are returned in the following priority order: exact SKU match > SKU prefix match > name match > ID match. For example, ?search=123 on products with {sku: "123"} and {sku: "123456"} returns the exact SKU match first.

price[gte] Number No

Price filter for products greater than and equals to particular amount

price[ne] Number No

Price filter for products not equals to particular amount

price[lte] Number No

Price filter for products less than and equals to particular amount

ids[] Array No

Filter by product ids

sortByField String No

Sort the results by a specific field. Default sort field is created_at when not passed.

Valid values:

  • "price"
  • "id"
  • "name"
  • "created_at"
createdSince String No

Filter (urlencoded) the products created after a given UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result.

alternativePrice[lt] Number No

Alternative price filter for products less than particular amount

limit Integer No

Number of documents per page

Default value: 50

name String No

Filter by product name, minimum 3 characters should be present for search.

alternativePrice[gte] Number No

Alternative price filter for products greater than and equals to particular amount

price[lt] Number No

Price filter for products less than particular amount

categories[] Array No

Filter by categories ids

alternativePrice[lte] Number No

Alternative price filter for products less than and equals to particular amount

price[eq] Number No

Price filter for products equals to particular amount

price[gt] Number No

Price filter for products greater than particular amount

alternativePrice[eq] Number No

Alternative price filter for products equals to particular amount

offset Integer No

Index of the first document in the page

Default value: 0

alternativePrice[gt] Number No

Alternative price filter for products greater than particular amount

isDeleted String No

Filter products by their deletion status. If false is passed, only products that are not deleted will be returned.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.