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

# Scenarios

> Mutations for running what-if scenario simulations.

## simulateScenario

Run a single scenario simulation against a product baseline.

```graphql theme={null}
mutation {
  simulateScenario(input: {
    baseProductId: "prod_abc123"
    quantity: 100
    overrides: [
      { parameter: MATERIAL, value: "bio_based_composite" },
      { parameter: TRANSPORT_METHOD, value: "RAIL" },
      { parameter: ENERGY_SOURCE, value: "SOLAR" }
    ]
  }) {
    baseline {
      co2Equivalent
      mkiScore
    }
    simulated {
      co2Equivalent
      mkiScore
    }
    delta {
      co2Equivalent
      mkiScore
      percentageChange
    }
    equivalency {
      description
      value
    }
  }
}
```

**Input:**

| Field           | Type                  | Required | Description                |
| --------------- | --------------------- | -------- | -------------------------- |
| `baseProductId` | ID!                   | Yes      | Product to use as baseline |
| `quantity`      | Int                   | No       | Quantity (default: 1)      |
| `overrides`     | \[ScenarioOverride!]! | Yes      | Parameter overrides        |

### ScenarioOverride

| Field       | Type               | Required | Description           |
| ----------- | ------------------ | -------- | --------------------- |
| `parameter` | ScenarioParameter! | Yes      | Parameter to override |
| `value`     | String!            | Yes      | New value             |

### ScenarioParameter enum

| Value              | Description                                                           |
| ------------------ | --------------------------------------------------------------------- |
| `MATERIAL`         | Material composition                                                  |
| `TRANSPORT_METHOD` | Transport type (`TRUCK`, `RAIL`, `SHIP`, `AIR`, `ELECTRIC_TRUCK`)     |
| `ENERGY_SOURCE`    | Energy source (`GRID`, `SOLAR`, `WIND`, `HYDRO`, `NATURAL_GAS`)       |
| `ORIGIN_COUNTRY`   | ISO country code                                                      |
| `PACKAGING`        | Packaging material                                                    |
| `RECYCLED_CONTENT` | Recycled content percentage (0-100)                                   |
| `END_OF_LIFE`      | End-of-life scenario (`LANDFILL`, `RECYCLE`, `INCINERATE`, `COMPOST`) |

## simulateScenarios

Compare multiple scenarios side-by-side.

```graphql theme={null}
mutation {
  simulateScenarios(input: {
    baseProductId: "prod_abc123"
    quantity: 100
    scenarios: [
      {
        name: "Bio-based + Rail"
        overrides: [
          { parameter: MATERIAL, value: "bio_based_composite" },
          { parameter: TRANSPORT_METHOD, value: "RAIL" }
        ]
      },
      {
        name: "Recycled + Electric"
        overrides: [
          { parameter: RECYCLED_CONTENT, value: "80" },
          { parameter: TRANSPORT_METHOD, value: "ELECTRIC_TRUCK" }
        ]
      },
      {
        name: "Full Green"
        overrides: [
          { parameter: MATERIAL, value: "bio_based_composite" },
          { parameter: TRANSPORT_METHOD, value: "RAIL" },
          { parameter: ENERGY_SOURCE, value: "SOLAR" },
          { parameter: RECYCLED_CONTENT, value: "90" }
        ]
      }
    ]
  }) {
    baseline { co2Equivalent mkiScore }
    results {
      name
      simulated { co2Equivalent mkiScore }
      delta { co2Equivalent mkiScore percentageChange }
      equivalency { description value }
    }
  }
}
```

For the full concept guide, see [Scenario Simulator](/core-concepts/scenario-simulator).