Get Classification by ID

URL

GET/pimapi/v1/classifications/{classificationId}

Retrieve metadata, attributes, and navigation properties for a specific classification system.

---

Path Parameters

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

Query Parameters

Parameter	Type	Required	Description
languageId	string	No	Language tag to localize descriptions (e.g., en, de). If omitted, all translated values are returned.

---

Request Examples

cURL

curl -X GET "https://dev.pxm.eu.prodexa.com/pxm/pimapi/v1/classifications/ECLASS_10?languageId=en" \
  -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?languageId=en", {
  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 the full classification metadata payload. Notice the navigation block providing a URL helper to fetch assigned groups.

{
  "status": 200,
  "meta": {
    "languageId": "en"
  },
  "data": {
    "classificationId": "ECLASS_10",
    "shortDescription": [
      {
        "languageId": "en",
        "value": "eCl@ss 10.0"
      }
    ],
    "longDescriptions": [
      {
        "languageId": "en",
        "value": "Standard eCl@ss classification system version 10.0 for product hierarchy"
      }
    ],
    "versionNo": "10.0",
    "orderNo": 1,
    "type": "ECLASS",
    "documentUrl1": "https://www.eclass.eu/",
    "documentUrl2": null,
    "documentUrl3": null,
    "attributes": [
      {
        "attributeId": "COLOR",
        "attribute.description": [
          {
            "languageId": "en",
            "value": "Color"
          }
        ]
      },
      {
        "attributeId": "WEIGHT",
        "attribute.description": [
          {
            "languageId": "en",
            "value": "Weight"
          }
        ]
      }
    ],
    "navigation": {
      "getGroups": "https://dev.pxm.eu.prodexa.com/pxm/pimapi/v1/classifications/ECLASS_10/groups?page=0&pageSize=20"
    },
    "createdOn": "2026-06-15T09:00:00Z",
    "createdBy": "admin",
    "changedOn": "2026-06-17T11:00:00Z",
    "changedBy": "admin"
  }
}

HTTP 404 Not Found Response

Returned if the classification system is not found.

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