API Documentation
Authentication APIs
- Login & Register
- Create & Manage Users
Catalog APIs
- GETList all products
- GETList all skus
- GETRetrieve a product
- GETRetrieve product variants
- GETRetrieve variant detail
- GETList all categories
- GETRetrieve product reviews
- POSTCreate product review
- GETRetrieve similar products
- GETRetrieve up sell products
- GETRetrieve cross sell products
- GETRetrieve recommended products
- POSTDatocms webhook
Cart & Checkout APIs
- Cart
- Checkout
Coupons & promotions API
Customers API
Orders APIs
Shipping APIs
Analytics
Campaigns API
Catalog APIs
List all categories
GET
/
catalog
/
categories
curl --request GET \
--url https://services.commercengine.dev/api/v1/x2yh61zw4k/admin/catalog/categories \
--header 'Authorization: Bearer <token>'
{
"message": "<string>",
"success": true,
"content": {
"categories": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"active": true,
"parent_category_id": "<string>",
"auto_assign_products": true,
"assign_products_condition": {},
"product_count": 123,
"created_at": "2023-11-07T05:31:56Z",
"modified_at": "2023-11-07T05:31:56Z",
"child_categories": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"active": true,
"parent_category_id": "<string>",
"auto_assign_products": true,
"assign_products_condition": {},
"product_count": 123,
"created_at": "2023-11-07T05:31:56Z",
"modified_at": "2023-11-07T05:31:56Z"
}
]
}
],
"pagination": {
"total_records": 123,
"total_pages": 123,
"previous_page": "<any>",
"limit": 123,
"next_page": "<any>"
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
to return child categories
use to check duplicity
to return categories upto specified nested level
page number of pagination list
Required range:
x > 1
no of rows per page
Required range:
x > 1
JSON string format: {"field1":"asc", "field2":"desc"}
search keyword
JSON - array of objects
Response
200 - application/json
OK
category ulid
Maximum length:
128
Maximum length:
128
parent category ulid
category ulid
Maximum length:
128
Maximum length:
128
parent category ulid
curl --request GET \
--url https://services.commercengine.dev/api/v1/x2yh61zw4k/admin/catalog/categories \
--header 'Authorization: Bearer <token>'
{
"message": "<string>",
"success": true,
"content": {
"categories": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"active": true,
"parent_category_id": "<string>",
"auto_assign_products": true,
"assign_products_condition": {},
"product_count": 123,
"created_at": "2023-11-07T05:31:56Z",
"modified_at": "2023-11-07T05:31:56Z",
"child_categories": [
{
"id": "<string>",
"name": "<string>",
"description": "<string>",
"active": true,
"parent_category_id": "<string>",
"auto_assign_products": true,
"assign_products_condition": {},
"product_count": 123,
"created_at": "2023-11-07T05:31:56Z",
"modified_at": "2023-11-07T05:31:56Z"
}
]
}
],
"pagination": {
"total_records": 123,
"total_pages": 123,
"previous_page": "<any>",
"limit": 123,
"next_page": "<any>"
}
}
}