Skip to main content
The PM Data Dictionary includes metadata, impacts, and additional product details Below is a dictionary of the most commonly used product module attributes to help with common operations. For indicators outside of this list, please contact Higg for more information.

Product Metadata

Metadata about the product.
FieldDescriptionType
id/idsproduct Higg ID. This is unique Higg system identifier. Results return ‘id’, search parameters use ‘ids’ to support multiple search ids.STRING
nameproduct nameSTRING
productTypeproduct type (Apparel, Footwear, Home Textiles, Other)STRING
productCategoryproduct type category, options depend on the product type chosen)STRING
productStyleNumber / modelNumberproduct style/model number. Use productStyleNumber to search, results return modelNumber. This field can be used to store PLM id, but note that the user can manually edit field in the Product Module tool interface.STRING
barcodesBarcodes (UPC/EAN) / Retail CodeSTRING
user:iduser who created product account idSTRING
user:emailuser who created productSTRING
account: idHigg system account idSTRING
account: nameName of the accountSTRING
account: countryCompany account countrySTRING
account: higgID/sacIdThis is the account ID. To search use higgID, results return sacIDSTRING
account: demoaccountAccount is set as demo account for testing, Demo (true)/Not Demo (False)BOOLEAN
createdResult for date product was createdunix timestamp, 1629492077829
lastEditedResult for date product was last edited.unix timestamp, 1629492077829
createdAfterSearch for products created after date”2021-01-13T16:38:19.386Z”
createdBeforeSearch for products created before date”2021-01-13T16:38:19.386Z”
lastEditedAfterSearch for products last edited after date”2021-01-13T16:38:19.386Z”
lastEditedBeforeSearch for products last edited before date”2021-01-13T16:38:19.386Z”
userEmailemail identifying who created the materialSTRING
platformCreatedBywho created the product (API, User). Note only products created after the API went live Sep 1, 2021 have this flag set.STRING
platformModifiedBywho last modified the product (API, User). Note only products created after the API went live Sep 1, 2021 have this flag set.STRING
draftProduct status, Draft (true)/FinalBOOLEAN
productNetWeightThe total product net weightDOUBLE
bomNetWeightThe product bill of materials net weightDOUBLE
grossWeightThe product gross weightDOUBLE

Product Bill of Materials

When creating products, the material/trim/packaging amounts and units of measure must be supplied. Part name is optional.
FieldDescriptionType
partNameOptional user-defined name for the partSTRING
amountamount of the material/trim/packaging in the productDOUBLE
measureUnitTrim and packaging this is “units”. Following units are available for base and custom materials: “kilograms”, “grams”, “milligram”, “pound”, “ounce”. If material has yield in MSI it is available as option.STRING

Product Impacts

The PM API search results return the total product impacts per use and absolute. “totalPerUseImpacts” are the total product per use impacts.
”scores” are the absolute total product impacts.
”scoresTotalAltProductCare” are the absolute total product impacts using alternative product care. Note these are to help inform brands internally and should not be communicated externally to consumer or other businesses.
FieldDescriptionType
globalWarmingGlobal Warming LCIA value (kg CO2 eq)DOUBLE
eutrophicationEutrophication LCIA value (kg PO4– eq)DOUBLE
waterScarcityWater Scarcity LCIA value (m3)DOUBLE
abioticDepletionAbiotic Resource Depletion, Fossil Fuels LCIA value (MJ eq)DOUBLE
chemistryChemistry LCIA value (units)DOUBLE
biogenicCarbonBiogenic Carbon Content LCIA value (kg CO2 eq)DOUBLE
waterConsumptionWater Consumption LCIA value (liters)DOUBLE

Stage Impacts

The PM API search results returns stage-level impacts per use and absolute. Absolute stage-level impacts
FieldDescription
billOfMaterialScoresBill of materials impacts
finishedGoodsScoresFinished Goods Manufacturing impacts
packagingImpactsExternal packaging not included in BoM impacts
logisticsImpactsLogistics impacts
retailImpactsDistribution center and retail impacts
productCareImpactsStandard product care impacts
endOfUseImpactsEnd of use impacts
Per use stage-level impacts
FieldDescription
bomPerUseImpactsBill of materials impacts
finishedPerUseImpactsFinished Goods Manufacturing impacts
packagingPerUseImpactsExternal packaging not included in BoM impacts
logisticsPerUseImpactsLogistics impacts
retailPerUseImpactsDistribution center and retail impacts
productCarePerUseImpactsStandard product care impacts
endOfUsePerUseImpactsEnd of use impacts

Certifications

Higg Product Module supports a limited selection of third-party certifications to attach to products. Accounts with certifications enabled have the ability to search, update, and create certifications using the PM API. If you are interested in turning certifications on for your account, please contact Higg for details.
FieldDescriptionType
idThis is the Higg system certificate identifierSTRING
assertionAuthorityNameList of supported certification authorizing bodies. For example, TextileExchangeID
assertionAuthorityIdThe ID for the assertionAuthorityNameDOUBLE
assertionStandardNameList of supported certification types. For example, Content Claim Standard (CCS)ID
assertionStandardIdThe ID for the assertionStandardNameDOUBLE
assertionIdThe certificate id the user enters, usually found on the certificateSTRING
certificateName, certificationNameThe name of the certificate the user enteres, usually found on the certificateSTRING
proofBodyThe Certifying / Issuing BodySTRING
dateIssuedThe date the certificate was issuedunix timestamp, 1629492077829
dateExpiresThe date the certificate expiresunix timestamp, 1629492077829
certificationFilesFile images of the certificateBase64
productModuleIdsHigg product ids to attach to a certificate when creating via APISTRING
addNewProductsadds products to existing certsSTRING
removeProductsremoves relationship between products and certsSTRING

Additional Product Details

Additional details about the product that the user can set manually in the Product Tool are also available via the API including Bill of Materials composition and individual material impacts, Finished Goods Processes, Manufacturing waste disposal, packaging, logistics mode of transport and distances, and distribution center and retail impacts. If you are interested in integrating this additional product information into your system, please contact Higg for details.