Skip to main content
GET
/
ecommerce
/
items
Get All Items
curl --request GET \
  --url https://api.rootfi.dev/v4/ecommerce/items \
  --header 'api_key: <api-key>'
{
  "data": [
    {
      "rootfi_id": 157,
      "rootfi_deleted_at": null,
      "rootfi_created_at": "2024-01-22T05:07:31.465Z",
      "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
      "rootfi_company_id": 1089,
      "platform_id": "prod_789",
      "name": "Wireless Headphones",
      "description": "Premium wireless headphones with noise cancellation",
      "sku": "WH-2024-BLK",
      "status": "active",
      "created_at": "2024-01-22T05:07:31.465Z",
      "updated_at": "2024-01-22T05:07:31.000Z",
      "variants": [
        {
          "rootfi_id": 3101,
          "platform_id": "var_shopify_001",
          "name": "Black - Medium",
          "sku": "WH-2024-BLK-M",
          "price": 99.99,
          "compare_at_price": 129.99,
          "currency_id": "USD",
          "status": "active"
        }
      ]
    }
  ],
  "prev": "eyJyb290ZmlfaWQiOjQ0MDA2MX0=",
  "next": "eyJyb291ZmlfaWQiOjQ0MDA2MX0=",
  "total_count": 123
}
The Items Data Model represents products with variants in your e-commerce platform. Items are the V4 unified model that replaces the Products endpoint, providing enhanced variant support and inventory tracking.

Authorizations

​
api_key
string
header
required

Query Parameters

​
limit
integer | null

The number of items you want to retrieve

​
next
string | null

The next page of objects to retrieve

​
prev
string | null

The previous page of objects to retrieve

​
expand
string | null

Comma separated fields to expand. Supported values are variants

​
select
string | null

Comma separated fields to select. Supported values are raw_data, data_hash

​
rootfi_updated_at[gte]
string | null

Filter by rootfi_updated_at Greater than or Equal To.

​
rootfi_company_id[eq]
integer | null

Filter by rootfi_company_id. You can filter by any field using this syntax field_name[operator]

​
status[eq]
string | null

Filter by item status. Values: active, archived, draft, unknown

​
return_count
string | null

Return the count of the objects. Supported values are true and false

​
sort[rootfi_created_at]
enum<string> | null

Sort by rootfi_created_at

Available options:
ASC,
DESC
​
sort[rootfi_updated_at]
enum<string> | null

Sort by rootfi_updated_at

Available options:
ASC,
DESC

Response

Successfully retrieved items

The data of the items endpoint.

​
data
ecommerceItemObject · object[]
required
​
prev
string | null

The previous page of objects to retrieve

​
next
string | null

The next page of objects to retrieve

​
total_count
integer | null

The total count of the objects