GET
https://api.posnova.store/v1/categoriesList 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