List Categories

Retrieve the active product categories of your store, ordered by their configured display order. Supports parent filtering for building nested navigation menus.

Query Parameters

Parameter	Description
limit integer • optional	Number of categories to return. Default 50, maximum 100.
page integer • optional	Page number for pagination. Default 1.
parent_id integer • optional	Only return sub-categories of this parent category.
search string • optional	Case-insensitive search on the category name.

Request Example

cURL

curl "https://api.posnova.store/v1/categories?parent_id=12" \
  -H "Authorization: Bearer pn_live_YourSecretKey"

JavaScript

const res = await fetch("https://api.posnova.store/v1/categories?parent_id=12", {
  headers: { Authorization: `Bearer ${process.env.POSNOVA_API_KEY}` },
});
const { data, pagination } = await res.json();

JSON Response

{
  "success": true,
  "data": [
    {
      "id": 12,
      "name": "Audio",
      "slug": "audio",
      "image": "https://…/audio.jpg",
      "description": "Headphones, speakers and more",
      "order": 1,
      "parent_id": null
    }
  ],
  "pagination": { "total": 8, "page": 1, "limit": 50 }
}

GET

https://api.posnova.store/v1/categories/{idOrSlug}

Retrieve Category

Fetch a single category by numeric ID or slug. Returns 404 when the category does not exist in your store.

Status: Operational

Brands API