---
title: "Create a submission"
method: POST
path: "/submission/{ref}"
---

# Create a submission

`POST /submission/{ref}`

## Path parameters

- `ref` string, required — The identifier of a schema

## Response `201`

The Scheme identified by the provided `ref`

- Scheme
  - `info` SchemeInfo, required
    - `ref` string
    - `name` string
  - `details` Details, required
    - `sector` 'Chemical industry' | 'Commerce' | 'Construction' | 'Electrical and instrument engineering' | 'Extraction, mining and agglomeration' | 'Food, beverages and tobacco' | 'Iron and steel' | 'Mechanical engineering and metal products' | 'Mineral products (eg glass, cement, bricks)' | 'Non ferrous metals' | 'Oil refineries' | 'Other' | 'Other industrial branches' | 'Paper, publishing and printing' | 'Power generation' | 'Public Administration' | 'Sewage treatment' | 'Textiles, clothing and footwear' | 'Transport' | 'Vehicles', required
    - `fuelBillFrequency` 'Monthly' | 'Quarterly' | 'Annually' | 'Other', required
    - `diagrams` string[], required
  - `primeMovers` PrimeMover[], required
    - `tagNumber` number, required
    - `type` string, required
    - `fuel` string, required
    - `manufacturer` string, required
    - `model` string, required
    - `yearCommissioned` number, required
    - `maximumRatedHeat` string, required
    - `maximumRatedPower` string, required
  - `boilers` Boiler[], required
    - `tagNumber` number, required
    - `type` string, required
    - `details` string, required
    - `manufacturer` string, required
    - `model` string, required
    - `yearCommissioned` number, required
    - `maximumRatedHeat` string, required
    - `maximumRatedPower` string, required
  - `additionalInformation` SchemeAdditionalInformation
    - `details` string
  - `meters` Meters, required
    - `fuelMeters` Meter[], required
      - `tag` string, required
      - `diagramReferenceNumber` string, required
      - `yearInstalled` number, required
      - `outputsRange` string, required
      - `outputsUnit` string, required
      - `modelType` string, required
      - `uncertainty` number, required
      - `meterPointReference` string
      - `serialNumber` string, required
      - `reading` union
        - FuelMeterReading
          - `fuelCategory` string
          - `fuelType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]
        - HeatMeterReading
          - `heatType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]
        - ElectricityMeterReading
          - `powerOutputType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]
    - `electricityMeters` Meter[], required
      - `tag` string, required
      - `diagramReferenceNumber` string, required
      - `yearInstalled` number, required
      - `outputsRange` string, required
      - `outputsUnit` string, required
      - `modelType` string, required
      - `uncertainty` number, required
      - `meterPointReference` string
      - `serialNumber` string, required
      - `reading` union
        - FuelMeterReading
          - `fuelCategory` string
          - `fuelType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]
        - HeatMeterReading
          - `heatType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]
        - ElectricityMeterReading
          - `powerOutputType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]
    - `heatMeters` Meter[], required
      - `tag` string, required
      - `diagramReferenceNumber` string, required
      - `yearInstalled` number, required
      - `outputsRange` string, required
      - `outputsUnit` string, required
      - `modelType` string, required
      - `uncertainty` number, required
      - `meterPointReference` string
      - `serialNumber` string, required
      - `reading` union
        - FuelMeterReading
          - `fuelCategory` string
          - `fuelType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]
        - HeatMeterReading
          - `heatType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]
        - ElectricityMeterReading
          - `powerOutputType` string
          - `haveUsedCalculations` boolean
          - `values` MeterReading[]

## Other responses

- `404` — No Scheme found for the provided `ref` parameter
- `500` — Unexpected error

## Changes

- **2023-03-31** `96fa702d766d` — 6 breaking, 5 info
  - the response property `additionalInformation` became optional for the status `201`
  - the response property `additionalInformation/details` became optional for the status `201`
  - the response property `info/name` became optional for the status `201`
  - the response property `info/ref` became optional for the status `201`
  - …7 more

[Change history](https://skmtc.dev/beis/apis/chpqa-alpha-prototype-api/changes/submission/:ref/post.md)

---

[API](https://skmtc.dev/beis/apis/chpqa-alpha-prototype-api.md) · [All operations](https://skmtc.dev/beis/apis/chpqa-alpha-prototype-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/beis/chpqa-alpha-prototype-api/revisions/96fa702d766d/schema)