---
title: "Saves or updates maritime annual emissions report data into the staging area. Data can be imported via the Maritime website. This endpoint will be available from 1 July 2026 in production environment"
method: PUT
path: "/external/v1.0/accounts/{company-imo-number}/aer/{year}"
tags: ["Maritime annual emissions report API"]
---

# Saves or updates maritime annual emissions report data into the staging area. Data can be imported via the Maritime website. This endpoint will be available from 1 July 2026 in production environment

`PUT /external/v1.0/accounts/{company-imo-number}/aer/{year}`

## Path parameters

- `company-imo-number` string, required
- `year` string, required

## Request body

- ExternalAer — The annual emissions report data
  - `shipParticulars` ExternalAerShipEmissions[], required — Ships and emission details. All ships related to the AER must be provided
    - `shipDetails` ExternalAerShipDetails, required — Ships and emission details
      - `shipImoNumber` string, required
      - `name` string, required — Name of the Ship as stated on IMO GISIS
      - `shipType` 'PAX' | 'RORO' | 'CONT' | 'OIL' | 'CHEM' | 'LNG' | 'GAS' | 'BULK' | 'GENERAL' | 'RCV' | 'VEH' | 'COMB' | 'ROPAX' | 'CONT_RORO' | 'CRUISE' | 'OFFSHORE' | 'OTHER', required
      - `grossTonnage` integer, required
      - `flag` 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BG' | 'BH' | 'BJ' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BY' | 'BZ' | 'CA' | 'CD' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GG' | 'GH' | 'GI' | 'GM' | 'GN' | 'GQ' | 'GR' | 'GT' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LK' | 'LR' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MG' | 'MH' | 'ML' | 'MM' | 'MN' | 'MO' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NE' | 'NG' | 'NI' | 'NL' | 'NO' | 'NR' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PT' | 'PW' | 'PY' | 'QA' | 'RO' | 'RS' | 'RU' | 'SA' | 'SB' | 'SC' | 'SL' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'TC' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WS' | 'YE' | 'ZA' | 'ZW', required — Code of the flag
      - `iceClassPolarCode` 'PC1' | 'PC2' | 'PC3' | 'PC4' | 'PC5' | 'PC6' | 'PC7' | 'IC' | 'IB' | 'IA' | 'IA_SUPER' | 'NA', required — Ice class polar code
      - `companyNature` 'SHIPOWNER' | 'ISM_COMPANY', required — Nature of the company for the ship referenced in this EMP
      - `allYear` boolean, required — Indicates if the reporting period of the ship covers the entire year
      - `from` string, date, nullable — Start date of the period. Required only when 'allYear' is false, otherwise must be omitted
      - `to` string, date, nullable — End date of the period. Required only when 'allYear' is false, otherwise must be omitted
    - `fuelTypes` ExternalAerFuelsAndEmissionsFactors[], required
      - `fuelOriginCode` 'FOSSIL' | 'BIOFUEL' | 'RFNBO', required
      - `fuelTypeCode` 'ETHANOL' | 'BIO_DIESEL' | 'HVO' | 'BIO_LNG' | 'BIO_METHANOL' | 'BIO_H2' | 'HFO' | 'LFO' | 'MDO' | 'MGO' | 'LNG' | 'LPG_BUTANE' | 'LPG_PROPANE' | 'H2' | 'NH3' | 'METHANOL' | 'E_DIESEL' | 'E_METHANOL' | 'E_LNG' | 'E_H2' | 'E_NH3' | 'E_LPG' | 'E_DME' | 'OTHER', required — For fuelOriginCode FOSSIL allowed values: HFO, LFO, MDO, MGO, LNG, LPG_BUTANE, LPG_PROPANE, H2, NH3, METHANOL, OTHER. For fuelOriginCode BIOFUEL allowed values: ETHANOL, BIO_DIESEL, HVO, BIO_LNG, BIO_METHANOL, BIO_H2, OTHER. For fuelOriginCode RFNBO allowed values: E_DIESEL, E_METHANOL, E_LNG, E_H2, E_NH3, E_LPG, E_DME, OTHER. Use OTHER only if the fuel type is not listed for the corresponding fuel origin code
      - `otherFuelType` string — Description of the fuel type if not listed. Must be provided only when fuelTypeCode 'OTHER'
      - `ttwEFCarbonDioxide` number, required — Tank to wake emission factor for carbonDioxide. Positive or zero decimal number with integer part max 12 digits
      - `ttwEFMethane` number, required — Tank to wake emission factor for methane. Positive or zero decimal number with integer part max 12 digits
      - `ttwEFNitrousOxide` number, required — Tank to wake emission factor for nitrousOxide. Positive or zero decimal number with integer part max 12 digits
    - `emissionsSources` ExternalAerEmissionsSources[], required
      - `name` string, required
      - `emissionSourceTypeCode` 'MAIN_ENGINE' | 'AUX_ENGINE' | 'GAS_TURBINE' | 'BOILER' | 'INERT_GAS_GENERATOR' | 'FUEL_CELLS' | 'WASTE_INCINERATOR' | 'OTHER', required
      - `emissionSourceClassCode` 'BOILERS' | 'FUEL_CELLS' | 'GAS_TURBINE' | 'ICE' | 'INERT_GAS_GENERATOR' | 'LNG_DIESEL_DFSS' | 'LNG_LBSI' | 'LNG_OTTO_DFMS' | 'LNG_OTTO_DFSS' | 'WASTE_INCINERATORS', required
      - `fuelTypeCodes` ExternalEmpFuelOriginTypeName[], required
        - `fuelOriginCode` 'FOSSIL' | 'BIOFUEL' | 'RFNBO', required
        - `fuelTypeCode` 'ETHANOL' | 'BIO_DIESEL' | 'HVO' | 'BIO_LNG' | 'BIO_METHANOL' | 'BIO_H2' | 'HFO' | 'LFO' | 'MDO' | 'MGO' | 'LNG' | 'LPG_BUTANE' | 'LPG_PROPANE' | 'H2' | 'NH3' | 'METHANOL' | 'E_DIESEL' | 'E_METHANOL' | 'E_LNG' | 'E_H2' | 'E_NH3' | 'E_LPG' | 'E_DME' | 'OTHER', required
        - `otherFuelType` string — Description of the fuel type if not listed. Must be provided only when 'fuelTypeCode' is 'OTHER'
        - `slipPercentage` number, nullable — Emission factor of slipped fuel. Must be provided only when 'fuelTypeCode' is 'LNG', 'BIO_LNG', 'E_LNG' or 'OTHER'. Decimal number between 0.0000 and 1 (inclusive) with up to 1 integer digits and 4 fractional digits
      - `monitoringMethods` string[], required
    - `uncertaintyLevel` ExternalEmpUncertaintyLevel[], required — Level of uncertainty associated with the fuel monitoring methods
      - `monitoringMethodCode` 'BDN' | 'BUNKER_TANK' | 'FLOW_METERS' | 'DIRECT', required
      - `levelOfUncertaintyTypeCode` 'DEFAULT' | 'SHIP_SPECIFIC', required
      - `shipSpecificUncertainty` number, required — Specific value for the level of uncertainty. Decimal number between 0 and 100 (inclusive) with up to 3 integer digits and 2 fractional digits
    - `derogations` ExternalAerDerogations, required — Exemption from per voyage monitoring
      - `exceptionFromPerVoyageMonitoring` boolean, required
  - `reductionClaim` ExternalAerReductionClaim, required
    - `reductionClaimApplied` boolean, required — If true, the reduction claim data are required, otherwise must be omitted
    - `reductionClaimDetails` ExternalAerReductionClaimDetails
      - `fuelPurchaseList` ExternalAerReductionClaimPurchase[], required
        - `fuelOriginCode` 'FOSSIL' | 'BIOFUEL' | 'RFNBO', required
        - `fuelTypeCode` 'ETHANOL' | 'BIO_DIESEL' | 'HVO' | 'BIO_LNG' | 'BIO_METHANOL' | 'BIO_H2' | 'HFO' | 'LFO' | 'MDO' | 'MGO' | 'LNG' | 'LPG_BUTANE' | 'LPG_PROPANE' | 'H2' | 'NH3' | 'METHANOL' | 'E_DIESEL' | 'E_METHANOL' | 'E_LNG' | 'E_H2' | 'E_NH3' | 'E_LPG' | 'E_DME' | 'OTHER', required
        - `otherFuelType` string — Description of the fuel type if not listed. Must be provided only when 'fuelTypeCode' is 'OTHER'
        - `batchNumber` string, required
        - `fuelMass` number, required — Fuel mass. Positive decimal number with fraction part max 5 digits
        - `ttwEFCarbonDioxide` number, required — Tank to wake emission factor for carbonDioxide. Positive or zero decimal number with integer part max 12 digits
  - `emissions` ExternalAerAggregatedDataEmissions, required
    - `shipEmissions` ExternalAerAggregatedDataShipEmissions[], required
      - `shipImoNumber` string, required
      - `annualEmission` ExternalAerAggregatedDataAnnualEmission, required
        - `emissions` ExternalAerAggregatedDataFuelConsumption[], required
          - `fuelOriginCode` 'FOSSIL' | 'BIOFUEL' | 'RFNBO', required
          - `fuelTypeCode` 'ETHANOL' | 'BIO_DIESEL' | 'HVO' | 'BIO_LNG' | 'BIO_METHANOL' | 'BIO_H2' | 'HFO' | 'LFO' | 'MDO' | 'MGO' | 'LNG' | 'LPG_BUTANE' | 'LPG_PROPANE' | 'H2' | 'NH3' | 'METHANOL' | 'E_DIESEL' | 'E_METHANOL' | 'E_LNG' | 'E_H2' | 'E_NH3' | 'E_LPG' | 'E_DME' | 'OTHER', required
          - `otherFuelType` string — Description of the fuel type if not listed. Must be provided only when 'fuelTypeCode' is 'OTHER'
          - `amount` number, required — Fuel consumption amount. Positive or zero decimal number with fraction part max 5 digits
        - `etsEmissionsWithinUkPort` ExternalAerAggregatedDataEmissionsMeasurements, required
          - `tco2Total` number, required — Carbon dioxide. Positive or zero decimal number with fraction part max 7 digits
          - `tch4eqTotal` number, required — Methane. Positive or zero decimal number with fraction part max 7 digits
          - `tn2oeqTotal` number, required — Nitrous oxide. Positive or zero decimal number with fraction part max 7 digits
        - `etsEmissionsBetweenUkPort` ExternalAerAggregatedDataEmissionsMeasurements, required
          - `tco2Total` number, required — Carbon dioxide. Positive or zero decimal number with fraction part max 7 digits
          - `tch4eqTotal` number, required — Methane. Positive or zero decimal number with fraction part max 7 digits
          - `tn2oeqTotal` number, required — Nitrous oxide. Positive or zero decimal number with fraction part max 7 digits
        - `etsEmissionsBetweenUkAndNiPort` ExternalAerAggregatedDataEmissionsMeasurements, required
          - `tco2Total` number, required — Carbon dioxide. Positive or zero decimal number with fraction part max 7 digits
          - `tch4eqTotal` number, required — Methane. Positive or zero decimal number with fraction part max 7 digits
          - `tn2oeqTotal` number, required — Nitrous oxide. Positive or zero decimal number with fraction part max 7 digits

## Response `204`

No Content

## Other responses

- `400` — Bad Request Error Code | Description FORM1001 | Form validation failed FORM1002 | Parameters validation failed AER1004 | Business validation error
- `403` — Forbidden
- `404` — Not Found Error Code | Description AER1007 | AER does not exist for specific year
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/beis/apis/maritime-external-api.md) · [All operations](https://skmtc.net/beis/apis/maritime-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beis/maritime-external-api/revisions/14eeb8a653f5/schema)