---
title: "Validates and parses an emission factors xlsx file for the given reference year and keeps it as a pending upload until it is submitted"
method: POST
path: "/v1.0/installation/settings/emission-factors"
tags: ["Settings"]
---

# Validates and parses an emission factors xlsx file for the given reference year and keeps it as a pending upload until it is submitted

`POST /v1.0/installation/settings/emission-factors`

## Request

- Base URL: `http://localhost:8080/api`
- URL: `http://localhost:8080/api/v1.0/installation/settings/emission-factors`
- Auth: HTTP bearer

## Query parameters

- `referenceYear` integer, required

## Request body `multipart/form-data`

- object
  - `file` string, binary: The emission factors xlsx file

## Response `200`

OK

- EmissionFactorsUploadDTO
  - `fileUuid` string, uuid
  - `data` EmissionFactorsDetailDTO
    - `nationalInventory` EmissionFactorsNationalInventoryEntryDTO[]
      - `id` integer
      - `sectorName` string
      - `ukGhgFuel` string
      - `fuel` string
      - `emissionFactor` string, decimal
      - `netCalorificValue` string, decimal
      - `oxidationFactor` string, decimal
      - `ncvMeasurementUnit` 'GJ_PER_TONNE' | 'GJ_PER_NM3'
      - `efMeasurementUnit` 'TONNES_OF_CO2_PER_TJ' | 'TONNES_OF_CO2_PER_NM3' | 'TONNES_OF_CO2_PER_TONNE'
    - `regionalNaturalGas` EmissionFactorsRegionalNaturalGasEntryDTO[]
      - `chargingZoneCode` string
      - `chargingZoneName` string
      - `emissionFactor` string, decimal
      - `netCalorificValue` string, decimal
      - `calculationFactor` string, decimal

## Other responses

- `400`: Bad request
- `403`: Forbidden
- `500`: Internal Server Error

## Changes

- **2026-10-26** `187cc58f76f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beis/apis/mets-api-documentation/changes/v1.0/installation/settings/emission-factors/post.md)

---

[API](https://skmtc.dev/beis/apis/mets-api-documentation.md) - [All operations](https://skmtc.dev/beis/apis/mets-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/beis/apis/mets-api-documentation/revisions/187cc58f76f2?raw)