Skip to main content
GET
/
products
/
category
List categories
curl --request GET \
  --url https://store.salesive.com/api/v1/products/category \
  --header 'Authorization: Bearer <token>' \
  --header 'x-shop-id: <api-key>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "slug": "<string>",
    "description": "<string>",
    "image": "<string>"
  }
]

​
Request

GET /products/category

​
200 response

[
    {
        "id": "68bc52c7e15404b8e40a7c37",
        "name": "Apparel",
        "slug": "apparel",
        "description": "Wearables and fashion accessories",
        "image": "https://cdn.salesive.com/categories/apparel.png"
    }
]

Authorizations

​
Authorization
string
header
required

JWT issued by the Salesive Store API for authenticated shoppers.

​
x-shop-id
string
header
required

Optional storefront identifier sent as a header to scope responses to a specific shop. Try It requests remember this value once provided.

Headers

​
x-shop-id
string

Optional identifier that scopes responses to a specific storefront when the referer cannot be inferred.

Response

200 - application/json

Category list response.

​
id
string
required

Unique category identifier.

​
name
string
required

Display name of the category.

​
slug
string
required

URL-friendly identifier for the category.

​
description
string

Optional description of the category.

​
image
string<uri>

Optional image URL for the category.