Automate your
carbon reporting

// Aggregate emissions across all five APIs for annual disclosure
$report = [
    'reporting_period' => '2025-01-01 / 2025-12-31',
    'methodology'      => 'GHG Protocol Corporate Standard',
    'gwp'              => 'IPCC AR6 GWP100',
];

// Scope 1 — Direct emissions (fuel burned on-site)
$fuelRecords = FuelRecord::whereYear('date', 2025)->get();
foreach ($fuelRecords as $record) {
    $res = Http::withToken($apiKey)->get('https://api.emissions.dev/v1/fuel/emissions', [
        'fuel_type' => $record->fuel_type,
        'value'     => $record->kwh,
        'unit'      => 'kwh',
    ]);
    $scope1 += $res->json('data.attributes.emissions.ghg_protocol_scopes.scope_1');
}

// Scope 2 — Purchased electricity (per-office, per-country)
$offices = Office::with('electricityBills')->get();
foreach ($offices as $office) {
    $res = Http::withToken($apiKey)->get('https://api.emissions.dev/v1/electricity/emissions', [
        'country' => $office->country_code,
        'state'   => $office->state_code,
        'kwh'     => $office->annual_kwh,
    ]);
    $scope2 += $res->json('data.attributes.emissions.ghg_protocol_scopes.scope_2.location_based');
}

// Scope 3 Cat. 4 — Upstream freight
$shipments = Shipment::whereYear('shipped_at', 2025)->get();
foreach ($shipments as $s) {
    $res = Http::withToken($apiKey)->get('https://api.emissions.dev/v1/freight/emissions', [
        'origin_country'      => $s->origin_country,
        'destination_country'  => $s->dest_country,
        'weight'              => $s->weight_kg,
        'transport_mode'      => $s->mode,
    ]);
    $scope3_cat4 += $res->json('data.attributes.emissions.ghg_protocol_scopes.freight_buyer.scope_3_category_4');
}

// Scope 3 Cat. 6 — Business travel (flights + hotels)
$trips = BusinessTrip::whereYear('departure_date', 2025)->get();
foreach ($trips as $trip) {
    $flight = Http::withToken($apiKey)->get('https://api.emissions.dev/v1/travel/emissions', [
        'origin'      => $trip->origin_iata,
        'destination' => $trip->dest_iata,
        'mode'        => 'flight',
        'class'       => $trip->cabin_class,
    ]);
    $hotel = Http::withToken($apiKey)->get('https://api.emissions.dev/v1/hotel/emissions', [
        'country' => $trip->hotel_country,
        'nights'  => $trip->hotel_nights,
    ]);
    $scope3_cat6 += $flight->json('data.attributes.emissions.co2e')
                  + $hotel->json('data.attributes.emissions.co2e');
}

// Complete GHG Protocol disclosure
$report['scope_1']           = round($scope1, 1);
$report['scope_2_location']  = round($scope2, 1);
$report['scope_3_category_3'] = 'WTT included in each API response';
$report['scope_3_category_4'] = round($scope3_cat4, 1);
$report['scope_3_category_6'] = round($scope3_cat6, 1);
$report['total_co2e_kg']     = round($scope1 + $scope2 + $scope3_cat4 + $scope3_cat6, 1);