Contents
On this page
List Groups - Plugixa Extra Product Options
GET /plugixa-epo/v1/groups
Every option group, drafts included, in their order (lowest priority first), as the Option groups list shows them. Each row is a summary: read one group in full with Get Group. See Option groups.
Needs a user with the plugixa_epo_manage capability (signed in with an Application Password, or the login cookie with an X-WP-Nonce header). Administrators and shop managers hold it; see Permissions.
Request
GET https://your-store.example/wp-json/plugixa-epo/v1/groups
Responses
200 OK. data is the list of groups.
{
"success": true,
"data": [
{
"id": 7,
"title": "Gift options",
"status": "published",
"priority": 10,
"dirty": false,
"field_count": 3,
"targets": {
"all": false,
"products": [],
"categories": [21]
},
"published_at": "2026-11-21T09:14:02",
"modified_at": "2026-11-21T09:14:02"
},
{
"id": 8,
"title": "Engraving",
"status": "draft",
"priority": 20,
"dirty": true,
"field_count": 2,
"targets": {
"all": false,
"products": [54, 61],
"categories": []
},
"published_at": null,
"modified_at": "2026-11-21T10:02:45"
}
],
"meta": {
"total": 2
}
}
| Field | Type | Meaning |
|---|---|---|
id |
integer |
The group’s id |
title |
string |
The group’s name |
status |
string |
draft, published or disabled |
priority |
integer |
Lower comes first on a product |
dirty |
boolean |
true when the draft has unpublished changes |
field_count |
integer |
Fields in the draft |
targets |
object |
Where the draft shows: see the group document |
published_at |
string |
UTC, or null |
modified_at |
string |
UTC |
meta.total |
integer |
Number of groups |
There is no paging: stores rarely have more than a few dozen groups.
Errors
| Status | Code | When |
|---|---|---|
401 / 403 |
plugixa_epo_forbidden |
The caller lacks the capability: You are not allowed to do that. |
Plus the errors every endpoint can return.
Examples
curl -s "https://your-store.example/wp-json/plugixa-epo/v1/groups" \
-u "$WP_USER:$WP_APP_PASSWORD"
<?php
$ch = curl_init('https://your-store.example/wp-json/plugixa-epo/v1/groups');
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-store.example/wp-json/plugixa-epo/v1/groups', {
headers: {
'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
},
});
const { data } = await response.json();
Quick Links
Share