Products API

This page covers everything you can do with products over the REST API — from listing and filtering to partial updates and deletion. Each endpoint below uses the same authentication headers, so grab your access token and follow along.

Common Headers

Every request on this page sends the same two headers:

Key	Value
Accept	application/json
Authorization	Bearer access_token

Get All Products

Retrieves a paginated list of products. Use it to browse the catalog or, combined with filters, to pull exactly the subset you need.

GET {{url}}/api/v1/rest/products

Headers — use the Common Headers.

You can shape the result set with these query parameters:

Name	Info	Type	Default
limit	The number of products to retrieve per request	Number	10
page	Page number to retrieve	Number	1
filters	Criteria to filter the records returned	JSON	N/A
with_completeness	Returns completeness scores for the product	Boolean	false

Usage Examples

• Limit: Retrieve 10 products per page.

  GET {{url}}/api/v1/rest/products?limit=10

• Page: Fetch products from page 1.

  GET {{url}}/api/v1/rest/products?page=1

• With Completeness: Fetch completeness scores for the product.

  GET {{url}}/api/v1/rest/products?with_completeness=true

• Filters: Filters refine query results based on specific product attributes. You can combine multiple filters to achieve the desired output.

  Available Filters

  1. sku

     • Operators:
       • =: Exact match for the specified SKU.
       • IN: Matches any of the SKUs in the provided list.
       • NOT IN: Excludes any of the SKUs in the provided list.

  2. parent

     • Operators:
       • =: Exact match for the parent value.

  3. status

     • Operators:
       • =: Exact match for the status value.

  4. categories

     • Operators:
       • IN: Matches any of the categories in the provided list.
       • NOT IN: Excludes any of the categories in the provided list.

  5. family

     • Operators:
       • IN: Matches any of the family types in the provided list.
       • NOT IN: Excludes any of the family types in the provided list.

Example Usage

• Filter by SKU: Retrieve products with specific SKUs.

  {"sku":[{"operator":"IN","value":["305312", "584577"]}]}

• Filter by Parent: Retrieve products with the parent set to "root".

  {"parent":[{"operator":"=","value":"root"}]}

• Filter by Status: Retrieve products with status set to true.

  {"status":[{"operator":"=","value":true}]}

• Combined Query: Retrieve 10 products from page 1 that belong to the root parent and have a status of true.

  GET {{url}}/api/v1/rest/products?limit=10&page=1&filters={"parent":[{"operator":"=","value":"root"}],"status":[{"operator":"=","value":true}]}

Response

The response returns a paginated list of products in JSON format:

Response

{
  "data": [
    {
      "sku": "100PS3333",
      "status": true,
      "parent": null,
      "family": "default",
      "type": "simple",
      "additional": null,
      "created_at": "2025-06-27T07:20:58.000000Z",
      "updated_at": "2025-06-27T07:23:37.000000Z",
      "values": {
        "common": {
          "sku": "100PS3333",
          "size": "L",
          "color": "Yellow",
          "image": false,
          "url_key": "sample Product",
          "product_number": "Product Number"
        },
        "categories": ["root"],
        "channel_specific": {
          "default": {
            "cost": {"USD": "12"}
          }
        },
        "channel_locale_specific": {
          "default": {
            "en_AU": {
              "name": "Name",
              "price": {"USD": "12"},
              "meta_title": "Meta Title",
              "description": "<p>&nbsp; Description for Product<\/p>",
              "meta_keywords": "meta Keyword",
              "meta_description": "meta Description",
              "short_description": "<p>Short Description&nbsp; for Product<\/p>"
            }
          }
        }
      },
      "completeness": [
        {
          "channel": "default",
          "locale": "en_AU",
          "score": 100
        },
        {
          "channel": "default",
          "locale": "fr_FR",
          "score": 0
        },
        {
          "channel": "ecommerce",
          "locale": "de_DE",
          "score": 0
        },
      ]
    },
    {
      "sku": "100PS",
      "status": true,
      "parent": null,
      "family": "default",
      "type": "simple",
      "additional": null,
      "created_at": "2025-06-27T07:37:01.000000Z",
      "updated_at": "2025-06-27T07:39:07.000000Z",
      "values": {
        "common": {
          "sku": "100PS",
          "size": "M",
          "color": "Green",
          "url_key": "sample Product Test",
          "product_number": "123452"
        },
        "categories": ["root"],
        "channel_specific": {
          "default": {
            "cost": {"USD": "23"}
          }
        },
        "channel_locale_specific": {
          "default": {
            "en_AU": {
              "name": "Product Name",
              "price": {"USD": "23"},
              "meta_title": "Meta",
              "description": "<p>Description For Product<\/p>",
              "meta_keywords": "Key",
              "meta_description": "Description",
              "short_description": "<p>Short Description For Product<\/p>"
            }
          }
        }
      },
      // When there is no completeness setting for this family and product completeness is not calculated blank array is returned
      "completeness": []
    }
  ],
  "current_page": 1,
  "last_page": 1,
  "total": 2,
  "links": {
      "first": "{{url}}/api/v1/rest/products?page=1",
      "last": "{{url}}/api/v1/rest/products?page=1",
      "next": null,
      "prev": null
  }
}

Get Product by SKU

Fetches a single product when you already know its SKU — handy for detail views and sync checks.

GET {{url}}/api/v1/rest/products/{sku}

Headers — use the Common Headers.

The endpoint takes one path parameter:

Name	Description	Type
sku	The unique SKU of the product	String

Example:

GET {{url}}/api/v1/rest/products/100PS3333

You can also request completeness data alongside the product:

Name	Info	Type	Default
with_completeness	Returns completeness scores for the product	Boolean	false

Example:

GET {{url}}/api/v1/rest/products/100PS3333?with_completeness=true

Response

The full product record is returned:

Response

{
  "sku": "100PS3333",
  "status": true,
  "parent": null,
  "family": "default",
  "type": "simple",
  "additional": null,
  "created_at": "2025-06-27T07:20:58.000000Z",
  "updated_at": "2025-06-27T07:23:37.000000Z",
  "values": {
    "common": {
      "sku": "100PS3333",
      "size": "L",
      "color": "Yellow",
      "image": false,
      "url_key": "sample Product",
      "product_number": "Product Number"
    },
    "categories": ["root"],
    "channel_specific": {
      "default": {
        "cost": {"USD": "12"}
      }
    },
    "channel_locale_specific": {
      "default": {
        "en_AU": {
          "name": "Name",
          "price": {"USD": "12"},
          "meta_title": "Meta Title",
          "description": "<p>&nbsp; Description for Product<\/p>",
          "meta_keywords": "meta Keyword",
          "meta_description": "meta Description",
          "short_description": "<p>Short Description&nbsp; for Product<\/p>"
        }
      }
    }
  },
  "completeness": [
    {
      "channel": "default",
      "locale": "en_AU",
      "score": 50
    },
    {
      "channel": "default",
      "locale": "fr_FR",
      "score": 80
    },
  ]
}

Create a Product

Creates a new simple product with the SKU, family, and attribute values you supply.

POST {{url}}/api/v1/rest/products

Headers — use the Common Headers.

Send the complete product definition as the request body:

{
    "sku": "100PS3355",
    "status": true,
    "parent": null,
    "family": "default",
    "type": "simple",
    "additional": null,
    "values": {
        "common": {
            "sku": "100PS3355",
            "size": "L",
            "color": "Yellow",
            "image": false,
            "url_key": "sample Product API",
            "product_number": "Product 122"
        },
        "categories": [
            "root"
        ],
        "channel_specific": {
            "default": {
                "cost": {
                    "USD": "12"
                }
            }
        },
        "channel_locale_specific": {
            "default": {
                "en_AU": {
                    "name": "Name",
                    "price": {
                        "USD": "12"
                    },
                    "meta_title": "Meta Title",
                    "description": "<p>&nbsp; Description for Product</p>",
                    "meta_keywords": "meta Keyword",
                    "meta_description": "meta Description",
                    "short_description": "<p>Short Description&nbsp; for Product</p>"
                }
            }
        }
    }
}

Response

A successful creation returns a confirmation message:

Response

{
  "success": true,
  "message": "Product created successfully"
}

Update a Product

Replaces a product's data with the payload you send. Use it when you have the full record; for partial changes, prefer Patch a Product.

PUT {{url}}/api/v1/rest/products/{sku}

Headers — use the Common Headers.

The endpoint takes one path parameter:

Name	Description	Type
sku	The unique SKU of the product	String

Example:

PUT {{url}}/api/v1/rest/products/100PS3355

Send the updated product as the request body:

{
    "sku": "100PS3355",
    "status": true,
    "parent": null,
    "family": "default",
    "type": "simple",
    "additional": null,
    "values": {
        "common": {
            "sku": "100PS3355",
            "size": "M",
            "color": "Yellow",
            "image": false,
            "url_key": "sample Product API",
            "product_number": "Product 123"
        },
        "categories": [
            "root"
        ],
        "channel_specific": {
            "default": {
                "cost": {
                    "USD": "122"
                }
            }
        },
        "channel_locale_specific": {
            "default": {
                "en_AU": {
                    "name": "Name Update",
                    "price": {
                        "USD": "122"
                    },
                    "meta_title": "Meta Title",
                    "description": "<p>&nbsp; Description for Product Update</p>",
                    "meta_keywords": "meta Keyword",
                    "meta_description": "meta Description",
                    "short_description": "<p>Short Description&nbsp; for Product</p>"
                }
            }
        }
    }
}

Response

A successful update returns a confirmation message:

Response

{
  "success": true,
  "message": "Product updated successfully"
}

Patch a Product

Applies a partial update — only the fields you send are changed, and everything else keeps its current value.

PATCH {{url}}/api/v1/rest/products/{sku}

Headers — use the Common Headers.

The endpoint takes one path parameter:

Name	Description	Type
sku	The unique SKU of the product	String

Example:

PATCH {{url}}/api/v1/rest/products/100PS3355

Only include the fields that need to be updated in the request body:

{
    "values": {
        "common": {
            "Name": "Updated Product Name",
            "description": "<p>Partially Updated Description</p>"
        },
        "categories": [
            "master",
            "master_accessories"
        ]
    }
}

Response

A successful patch returns a confirmation message:

Response

{
  "success": true,
  "message": "Product updated successfully"
}

Delete a Product

Permanently removes a product by its SKU.

DELETE {{url}}/api/v1/rest/products/{sku}

Headers — use the Common Headers.

The endpoint takes one path parameter:

Name	Description	Type
sku	The unique SKU of the product	String

Example:

DELETE {{url}}/api/v1/rest/products/100PS3355

Response

The deleted SKU is echoed back so you can confirm the right product was removed:

Response

{
  "success": true,
  "message": "Product deleted successfully",
  "sku": "100PS3355"
}

Delta Synchronization 3.0

Products support incremental sync via date filters and cursor pagination — the recommended pattern for keeping an external system current:

GET {{url}}/api/v1/rest/products
    ?filters={"updated_at":[{"operator":">=","value":"2026-08-01 00:00:00"}]}
    &pagination_type=search_after
    &limit=100

The response replaces page metadata with a cursor:

{
    "data": [ ... ],
    "search_after": 1234,
    "links": {
        "next": "...?pagination_type=search_after&search_after=1234"
    }
}

Follow links.next until search_after is null. Supported date operators on created_at / updated_at: >, >=, <, <=, BETWEEN (exactly two values). See What's New in the v3.0 API for details.