Get Classification Groups

URL

GET/pimapi/v1/classifications/{classificationId}/groups

Retrieve a paged list of top-level or child classification groups assigned to a specific classification system.

---

Path Parameters

Parameter	Type	Required	Description
classificationId	string	Yes	Unique ID of the classification system (e.g., ECLASS_10).

Query Parameters

Parameter	Type	Required	Default	Description
languageId	string	No		Language tag to localize descriptions (e.g., en, de). If omitted, all translated values are returned.
page	integer	No	0	Zero-indexed page number for pagination.
pageSize	integer	No	20	Number of items to return per page.

Note

By default, results are sorted ascending by group order number (OrderNo: ASC).

---

Request Examples

cURL

curl -X GET "https://dev.pxm.eu.prodexa.com/pxm/pimapi/v1/classifications/ECLASS_10/groups?page=0&pageSize=2" \
  -H "X-API-KEY: your_hex_api_key" \
  -H "Accept: application/json"

JavaScript (Fetch)

const headers = new Headers();
headers.append("X-API-KEY", "your_hex_api_key");
headers.append("Accept", "application/json");

fetch("https://dev.pxm.eu.prodexa.com/pxm/pimapi/v1/classifications/ECLASS_10/groups?page=0&pageSize=2", {
  method: 'GET',
  headers: headers
})
  .then(response => response.json())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

---

Response Structure

HTTP 200 OK Response

Returns a paginated payload wrapper containing a list of classification groups.

{
  "status": 200,
  "meta": {
    "languageId": "en",
    "page": 0,
    "pageSize": 2,
    "totalElements": 24,
    "totalPages": 12,
    "sorting": "OrderNo: ASC"
  },
  "data": [
    {
      "classificationGroupId": "SCREWS",
      "shortDescription": [
        {
          "languageId": "en",
          "value": "Screws"
        }
      ],
      "fallbackDescShort": [
        {
          "languageId": "en",
          "value": "Screws"
        }
      ],
      "longDescriptions": [
        {
          "languageId": "en",
          "value": "Threaded metal screws and fasteners"
        }
      ],
      "documentUrl1": null,
      "documentUrl2": null,
      "documentUrl3": null,
      "orderNo": 10,
      "statusID": "ACTIVE",
      "attributes": [
        {
          "attributeId": "THREAD_SIZE",
          "attribute.description": [
            {
              "languageId": "en",
              "value": "Thread Size"
            }
          ]
        }
      ],
      "createdOn": "2026-06-15T09:00:00Z",
      "createdBy": "admin",
      "changedOn": "2026-06-17T11:00:00Z",
      "changedBy": "admin"
    },
    {
      "classificationGroupId": "NAILS",
      "shortDescription": [
        {
          "languageId": "en",
          "value": "Nails"
        }
      ],
      "fallbackDescShort": [
        {
          "languageId": "en",
          "value": "Nails"
        }
      ],
      "longDescriptions": [],
      "documentUrl1": null,
      "documentUrl2": null,
      "documentUrl3": null,
      "orderNo": 20,
      "statusID": "ACTIVE",
      "attributes": [],
      "createdOn": "2026-06-15T09:00:00Z",
      "createdBy": "admin",
      "changedOn": "2026-06-15T09:00:00Z",
      "changedBy": "admin"
    }
  ]
}

HTTP 404 Not Found Response

Returned if the classification system does not exist or has no assigned groups.

{
  "status": 404,
  "meta": {
    "languageId": "en"
  },
  "error": "No Classification groups found"
}