Contents
List Categories - Plugixa POS for WooCommerce
GET /plugixa-pos/v1/categories
The product categories the register shows as filter buttons.
Needs a user with the plugixa_pos_sell capability (signed in with an Application Password, or the login cookie with an X-WP-Nonce header). Administrators hold it; other roles only when you grant it.
Request
GET https://your-site.example/wp-json/plugixa-pos/v1/categories
Responses
200 OK. data is the list of categories.
{
"success": true,
"data": [
{
"id": 126,
"name": "Accessories",
"parent": 0,
"count": 6,
"image": "https://your-site.example/wp-content/uploads/2026/11/acc-tote-7-150x150.jpg"
},
{
"id": 123,
"name": "Candles",
"parent": 122,
"count": 3,
"image": "https://your-site.example/wp-content/uploads/2026/11/hom-cndl-fig-7-150x150.jpg"
}
]
}
| Field | Type | Meaning |
|---|---|---|
data[].id |
integer |
Category id, for category in List Products |
data[].name |
string |
Name |
data[].parent |
integer |
Parent category id, 0 at the top |
data[].count |
integer |
Products in it |
data[].image |
string |
Category image URL |
Like the product list, the answer carries an ETag and answers 304 to a matching If-None-Match.
Errors
This endpoint has no errors of its own.
Plus the errors every endpoint can return.
Examples
curl -s "https://your-site.example/wp-json/plugixa-pos/v1/categories" \
-u "$WP_USER:$WP_APP_PASSWORD"
<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-pos/v1/categories');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_USERPWD => getenv('WP_USER') . ':' . getenv('WP_APP_PASSWORD'),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
const response = await fetch('https://your-site.example/wp-json/plugixa-pos/v1/categories', {
headers: {
'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
},
});
const { data } = await response.json();
Quick Links
Share