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.

​
supplyChain

Retrieve the full supply chain graph for a product. 
query {
  supplyChain(productId: "prod_abc123", maxTier: 3) {
    product { id name }
    totalTiers
    totalSuppliers
    tiers {
      level
      suppliers {
        id
        name
        country
        transportMethod
        certificationId
        co2Contribution
        percentage
        children {
          id
          name
          country
          co2Contribution
        }
      }
    }
    aggregatedImpact {
      co2Equivalent
      mkiScore
    }
  }
}
Arguments:
ArgumentTypeRequiredDescription
productIdID!YesProduct identifier
maxTierIntNoMaximum tier depth to return (default: all)

​
supplyChainHotspots

Identify the biggest impact contributors in the supply chain. 
query {
  supplyChainHotspots(
    productId: "prod_abc123"
    metric: CO2_EQUIVALENT
    limit: 5
  ) {
    supplier {
      id
      name
      country
      tier
    }
    contribution
    percentage
    recommendation
  }
}
Arguments:
ArgumentTypeRequiredDescription
productIdID!YesProduct identifier
metricImpactMetric!YesMetric to analyze
limitIntNoNumber of hotspots (default: 10)
Response example: 
{
  "data": {
    "supplyChainHotspots": [
      {
        "supplier": {
          "id": "sup_002",
          "name": "BioResin GmbH",
          "country": "DE",
          "tier": 2
        },
        "contribution": 3.1,
        "percentage": 25.0,
        "recommendation": "Consider local sourcing to reduce transport impact"
      }
    ]
  }
}