Contents
On this page

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