> ## 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.

# Supply Chain

> Query supply chain hierarchies and hotspot analysis.

## supplyChain

Retrieve the full supply chain graph for a product.

```graphql theme={null}
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:**

| Argument    | Type | Required | Description                                 |
| ----------- | ---- | -------- | ------------------------------------------- |
| `productId` | ID!  | Yes      | Product identifier                          |
| `maxTier`   | Int  | No       | Maximum tier depth to return (default: all) |

## supplyChainHotspots

Identify the biggest impact contributors in the supply chain.

```graphql theme={null}
query {
  supplyChainHotspots(
    productId: "prod_abc123"
    metric: CO2_EQUIVALENT
    limit: 5
  ) {
    supplier {
      id
      name
      country
      tier
    }
    contribution
    percentage
    recommendation
  }
}
```

**Arguments:**

| Argument    | Type          | Required | Description                      |
| ----------- | ------------- | -------- | -------------------------------- |
| `productId` | ID!           | Yes      | Product identifier               |
| `metric`    | ImpactMetric! | Yes      | Metric to analyze                |
| `limit`     | Int           | No       | Number of hotspots (default: 10) |

**Response example:**

```json theme={null}
{
  "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"
      }
    ]
  }
}
```