Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.heychocolate.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Product type

type Product {
  id: ID!
  name: String!
  description: String
  sku: String
  sectorTag: SectorTag!
  materialComposition: [MaterialComponent!]!
  impactScore: ImpactScore
  epd: Epd
  dpp: DigitalProductPassport
  supplyChain: SupplyChain
  certifications: [String!]!
  sectorMetadata: JSON
  images: [String!]!
  createdAt: DateTime!
  updatedAt: DateTime!
}

type ImpactScore {
  co2Equivalent: Float!
  mkiScore: Float
  waterFootprint: Float
  energyUse: Float
  unit: String!
  calculatedAt: DateTime!
  equivalencies: [Equivalency!]!
  breakdown: [ImpactBreakdown!]!
}

type ImpactBreakdown {
  phase: LifecyclePhase!
  contribution: Float!
  percentage: Float!
}

type MaterialComponent {
  name: String!
  percentage: Float!
  recycledContent: Float
  origin: String
  isBioBased: Boolean!
}

type Equivalency {
  category: EquivalencyCategory!
  description: String!
  value: String!
  icon: String!
  locale: String!
}

enum SectorTag {
  AGRI
  FOOD
  HIGHTECH_MANUFACTURING
  GREEN_CHEMISTRY
  TRADE
}

enum LifecyclePhase {
  RAW_MATERIALS
  MANUFACTURING
  TRANSPORT
  USE_PHASE
  END_OF_LIFE
}

enum EquivalencyCategory {
  TRANSPORT
  HOUSEHOLD
  NATURE
  FOOD
  ENERGY
  TIME
}

​
Fields

FieldTypeDescription
idID!Unique product identifier
nameString!Product name
sectorTagSectorTag!Industry sector classification
materialComposition[MaterialComponent!]!Material breakdown
impactScoreImpactScoreCalculated sustainability scores
epdEpdLinked Environmental Product Declaration
dppDigitalProductPassportLinked Digital Product Passport
supplyChainSupplyChainSupply chain graph
certifications[String!]!Environmental certifications
sectorMetadataJSONSector-specific fields (flexible schema)

​
Sector metadata

The sectorMetadata field contains sector-specific data as a flexible JSON object: Agri: 
{ "soilUsage": "organic", "waterConsumption": 1200, "fertilizerType": "natural", "cropYield": 4500 }
Food: 
{ "ingredientOrigins": ["NL", "BE"], "packagingType": "recyclable", "foodMiles": 350, "organicCertified": true }
Hightech Manufacturing: 
{ "rareEarthMetals": ["neodymium"], "energyClass": "A++", "repairabilityScore": 8, "eWasteCategory": "WEEE" }
Green Chemistry: 
{ "bioBasedPercentage": 85, "chemicalSafetyProfile": "non-toxic", "circularityIndex": 0.72 }
Trade: 
{ "transportModes": ["SHIP", "TRUCK"], "warehouseEmissions": 2.1, "lastMileMethod": "electric" }

​
Example query

query {
  product(id: "prod_abc123") {
    id
    name
    sectorTag
    materialComposition {
      name
      percentage
      isBioBased
    }
    impactScore {
      co2Equivalent
      mkiScore
      equivalencies {
        description
        value
        icon
      }
      breakdown {
        phase
        contribution
        percentage
      }
    }
    sectorMetadata
  }
}