Documentation

Commerce Engine Docs

Storefront API Reference

Admin API Reference

Return to site

Support

Add Item to cart. To delete item from cart, pass quantity = 0

Add/delete cart item

This cart model is structured to capture a wide range of details, facilitating accurate representation and management of user shopping carts in an e-commerce platform.

Indicates whether the cart is currently active or inactive.

List containing detailed information about each item in the cart. 

Details about the currency being used, including `name`, `code`, and `symbol`.

Email of the customer associated with the cart.

customer note for shipping or product customization.

the expiration timestamp of the shopping cart. .


Indicates if a promotion is applied or not.

Indicates if items in the cart are on subscription.

Discount amount due to promotions(If Applied).

Cart

string

This Cart Item model captures the attributes of a cart item, including product details, pricing information, subscription details, and other relevant information related to Cart Item.

Indicates if the product is offered for free.

The original listing price of the product.

Indicates whether the product is currently on offer.

Indicates whether the product is part of a promotion.

Indicates whether the product is currently on a subscription.

The price at which the product is being sold.

Additional cost for shipping associated with the product.

Stock Keeping Unit, a unique identifier for the product within inventory.

Indicates if the product is eligible for subscription.

Interval for the subscription (e.g., monthly).

Name or identifier of the subscription plan.

Indian Rupee

Two-letter code begin with a plus sign prefix that identifies different countries. By default it will be +91 if not provided.


10 digit phone number without country code.

Authorization

Welcome to the home of your new documentation

Introduction

Getting Started with Commerce Engine Storefront APIs

Quickstart

Learn about the various Commerce Engine modules and how to use them to add features to your storefront

Modules

You can customise the behaviour of your storefront by updating the store settings from the Commerce Engine app

Store Settings

Example section for showcasing API endpoints

This API’s focus is on anonymous users who have not undergone the formal account creation process. These anonymous users are associated with a unique identifier called a ULID, ensuring that even in the absence of a fully realized account, there is a distinct and trackable identity for each user. 
To interact with the system, each anonymous user is issued an access token. This access token plays a dual role in the system: it serves as a means of authenticating the user and it also acts as a tool for authorization, determining what actions the authenticated user is permitted to perform.

Anonymous user

This API enables users to authenticate into the system using their phone number. It provides a secure way for users to log in by verifying their identity through a one-time password (OTP) sent to their registered phone.

Login with phone

This API enables users to authenticate into the system using their email address. It provides a secure way for users to Login by verifying their identity through a one-time password (OTP) sent to their email address.

Login with email

This API enables users to authenticate into the system using their WhatsApp Number. It provides a secure way for users to Login by verifying their identity through a one-time password (OTP) sent to their WhatsApp Number.

Login with whatsapp

This API endpoint allows users to Login using their password. It requires the following parameters: email/phone and password. Also allows users to securely Login and obtain access and refresh tokens for subsequent API calls.

Login with password

This API endpoint allows you to verify a one-time password (OTP) for authentication purposes. By sending a request to this endpoint with the necessary parameters, you can confirm the validity of the OTP provided by the user.

Verify OTP

This API provides the functionality to register a user using their phone number. This allows you to securely register users and obtain access and refresh tokens for subsequent API calls.

Register with phone

The API allows users to register with their email address. This endpoint enables the registration process by requesting the user's email, first name, last name, phone number, and OTP token.
The response will include a message indicating the success or failure of the registration process, as well as additional information such as the user's information, access token and refresh token.

Register with email

The API allows users to register with their WhatsApp. This endpoint enables the registration process by requesting the user's WhatsApp number, first name, last name, email, and OTP token.
The response will include a message indicating the success or failure of the registration process, as well as additional information such as the user's information, access token and refresh token.


Register with whatsapp

The User Registration with Password API facilitates user onboarding by allowing registration through a combination of phone number and email. API collects essential registration details, including phone number, email, password and the confirmation of the chosen password.
The response will include a message indicating the success or failure of the registration process, as well as additional information such as the user's information, access token and refresh token.

Register with password

The Logout User API initiate the logout process for a user. Upon a successful request, the API responds with a confirmation message. If the user is not found or there's an issue with the request, an error response is returned with an appropriate message.

Logout user

The Refresh Access Token API is an integral component designed to enhance security and user experience. It enables clients to refresh their access tokens seamlessly, extending user sessions without compromising security.

Refresh access token

The Change Password API is a key feature designed to provide a secure and standardized method for users to update their passwords.

Change password

The Forgot Password API provides a secure mechanism for users to initiate the password recovery process. This API provides one-time password (OTP) token, which facilitas the resetting of user’s account password.

Forgot password

Reset password

The Retrieve User API is designed to facilitate the retrieval of comprehensive user information from the system. A required parameter is a user-id of the user whose information needs to be retrieved.

Retrieve a user

The Update User API helps to efficiently modify and enhance user information within the system, ensuring that user profiles remain accurate and up-to-date. This API provides a secure and flexible mechanism for updating specific details while maintaining adherence to established conventions.

Update a user

Retrieve user profile image API streamlines the process of retriving profile images associating with user accounts. Upon success, the API responds with a confirmation message. In case of errors, clear error messages facilitate quick issue resolution.

Retrieve a profile image

The Profile Image API streamlines the process of updating profile images associating with user accounts, offering a user-centric approach to visual identity customization. Upon success, the API responds with a confirmation message. In case of errors, clear error messages facilitate quick issue resolution. Overall, the Profile Image API enhances user engagement by seamlessly integrating personalized visual elements into digital platforms.

Update profile image

The Profile Image API streamlines the process of uploading profile images associating with user accounts, offering a user-centric approach to visual identity customization. Upon success, the API responds with a confirmation message. In case of errors, clear error messages facilitate quick issue resolution. Overall, the Profile Image API enhances user engagement by seamlessly integrating personalized visual elements into digital platforms.

Add profile image

Delete profile image API streamlines the process of removing profile images associating with user accounts. Upon success, the API responds with a confirmation message. In case of errors, clear error messages facilitate quick issue resolution.

Delete profile image

The Deactivate Account API providing users with a straightforward method to deactivate their accounts. Upon successful deactivation, the API responds with a confirmation message. Error responses are detailed, aiding developers in addressing issues promptly.

Deactivate account

The Retrieve Notification Preferences API allows clients to fetch a user's notification preferences based on their unique user identifier (user_id).

Retrieve user notification preferences

Update Notification Preferences API allows clients to update a user's notification preferences based on their unique user identifier (user_id).

Update user notification preferences

Create user notification preferences API allows clients to create a user's notification preferences based on their unique user identifier (user_id).

Create user notification preferences

Generating a One-Time Password (OTP) typically involves creating a random code that is sent to a user for authentication or verification purposes.

Generate OTP

The Check Verification Status API allows to verify the status of email and phone number verification for a specific user. Upon a successful request, the API responds with the verification status of the provided email and phone number. If the user is not found or there's an issue with the request, an error response is returned with an appropriate message.

Check verified email phone

Returns a list of your products. The products are returned sorted by creation date, with the most recently created products appearing first.

List all products

Returns a list of SKUs. The SKUs are returned sorted by creation date, with the most recently created SKUs appearing first.

List all SKUs

Retrieves the details of an existing product. Supply the unique product ID from either a product creation request or the product list, and Commerce Engine will return the corresponding product information.

Retrieve a product

Retrieves the variants of an existing product. Supply the unique product ID, and Commerce Engine will return the corresponding product variants information.

Retrieve product variants

Retrieves the details of a particular variant. Supply the unique product ID, and variant ID.

Retrieve variant detail

Returns a list of your product categories. The categories are returned sorted by creation date, with the most recently created categories appearing first.

List all categories

Retrieves a list of reviews for a specified product. The reviews are returned sorted by submission date, with the most recent reviews appearing first. You can filter the reviews by rating, reviewer, or date for more detailed analysis.

Retrieve product reviews

Create product review

Retrieves a list of products similar to a specified product based on their attributes and category. The similar products are returned sorted by relevance, with the most closely matching products appearing first. Useful for providing product recommendations to your customers.

Retrieve similar products

Retrieves a list of products specified for upsell. The upsell products are returned based on product ids specified in request param.

Retrieve up-sell products

Retrieves a list of products specified for cross selling. The cross-sell products are returned based on product ids specified in request param.

Retrieve cross-sell products

Retrieves a list of recommended products for a specified user based on their browsing history, past purchases, and indicated preferences. The recommended products are returned sorted by relevance, providing a personalized shopping experience for each user.

API Documentation

Authentication APIs

Catalog APIs

Cart & Checkout APIs

Coupons & promotions API

Customers API

Orders APIs

Shipping APIs

Payments API

Common API

Analytics

Campaigns API

Add/delete cart item

Authorizations

Path Parameters

Body

Response