Returns a HIERARCHICAL array of product groups.

Groups are a way of categorizing your product database, and several API calls support filtering by group.

Products can additionally be organized into categories (getProductCategories, hierarchical), brands (getBrands, a flat list), and priority groups (getProductPriorityGroups, a flat list)

Input parameters

Parameter nameDescriptionPossible valueRequired
productGroupIDFetch one specific product group.Integer
changedSinceFor synchronization; retrieve all product groups that have been updated after a certain time. To learn more about synchronization best practices, see Synchronizing Data with “changedSince”Integer (Unix timestamp)
searchAttributeNameName of attribute to search from. Both "searchAttributeName" and "searchAttributeValue" have to be specified.String
searchAttributeValueAttribute value to search for.String
langRetrieve item names in a specific language. If omitted, API will return item names in the default language of your ERPLY account.
Possible values:
  • 'eng' - English
  • 'spa' - Spanish
  • 'ger' - German
  • 'swe' - Swedish
  • 'fin' - Finnish
  • 'rus' - Russian
  • 'est' - Estonian
  • 'lat' - Latvian
  • 'lit' - Lithuanian
  • 'gre' - Greek
getAllLanguagesRetrive product group names in all languages. If you turn on this flag, API will return additional fields nameENG, nameGER, etc. — depending on which languages have been enabled on your account.0 or 1


Field nameTypeDescription
productGroupIDIntegerProduct group ID.
nameStringProduct group name.

Product groups can have different names in each language. Use input parameter lang to specify which language you want to retrieve. By default, API returns names in account's default language.

If you want to retrieve names in all languages with one API call, set input parameter getAllLanguages = 1. In addition to field name, API will then return fields nameENG, nameGER, etc. — one for each language enabled on your account.
showInWebshopInteger1 if product group should be displayed in webshop.
positionNoIntegerPosition number. When laying out the list of product groups, you can use this parameter to display them in intended order.
parentGroupIDIntegerParent product group ID.
imagesArrayArray, each item in which has the following attributes:

pictureID - Integer - ID of the image
thumbURL - String - URL of image thumbnail (100 x 100 px as configured by default)
smallURL - String - URL of a small version of the image (by default 200 x 200 px)
largeURL - String - URL of a large version of the image (by default 800 x 600 px)
subGroupsArrayArray of subgroups. Each subgroup has exactly the same structure as described here.
attributesArrayArray of attributes. Each item looks like this:

Field nameTypeDescription
attributeNameStringAttribute name
attributeTypeStringAttribute type
attributeValueStringAttribute value
vatratesArrayArray of product group-specific tax rates (used in US, for example). Each item looks like this:

Field nameTypeDescription
warehouseIDIntegerWarehouse ID
vatrateIDIntegerTax rate that applies to this product group in this location (warehouse).