Updates a removal in the Isometric system. The removal will be recalculated, if it is are not in an immutable state.

patch/removals/{id}

Request

  • Base URL
    https://api.isometric.com/mrv/v0
  • URL
    https://api.isometric.com/mrv/v0/removals/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:rmv_1EEM6NJXX1S0EXKD

Headers

x-client-secretstring required

A secret token identifying the client connecting to the API

Example:Syou3EZiO5vuMEgNyBeA8cjEMYOnQDwP

Request body

started_onstring date nullable

Date in ISO format (YYYY-MM-DD)

completed_onstring date nullable

Date in ISO format (YYYY-MM-DD)

Example request

{
  "delete_component_ids": [
    "cmp_1EP2SB7MZ1S036PY"
  ],
  "add_components": [
    {
      "component_id": "cmp_1EP2SB7MZ1S036PY",
      "removal_template_group_id": "rtg_1EGQ9DZXZ1S05S28",
      "attribution_factor_datapoint_id": "dtp_1DVKHKS101S0Q61Q"
    }
  ],
  "feedstock_type_id": "ftt_1D7KZ1P761S0G7BN"
}

Response

Successful Response

idstring required
supplier_reference_idstring nullable required

A string that must be unique for all resources created by a specific supplier. It can be used by a client to identify the correct objects in their system.

started_onstring date required
completed_onstring date required
co2e_net_removed_kgnumber required

The CO₂e removed by this removal once uncertainty discounting has been applied

co2e_net_removed_without_discount_kgnumber required

The CO₂e removed by this removal before any uncertainty discounting has been applied

co2e_net_removed_standard_deviation_kgnumber nullable required

The standard deviation of the CO₂e net removed and therefore the uncertainty discount applied to the removal

ghg_statement_idstring nullable required

The GHG statement ID that this removal is associated with. If null, the removal is in draft and has not been submitted for verification.

feedstock_type_idstring nullable required

The feedstock type ID that this removal is associated with.

risk_of_reversal_percentagenumber nullable required

The percentage of credits contributed to the buffer pool due to risk of reversal.

Example response

{
  "id": "rmv_1EEM6NJXX1S0EXKD",
  "ghg_statement_id": "ggs_1GDQJ99Z51S0DYW9",
  "feedstock_type_id": "ftt_1D7KZ1P761S0G7BN"
}

Changes

    • breaking

      for the path request parameter id, the minLength was increased from 0 to 20

    • warning

      for the path request parameter id, the maxLength was set to 37

    • info

      for the path request parameter id, the type was generalized from no type to string

    • breaking

      the //// request property's minLength was increased from 0 to 1

    • breaking

      the / response property's maxLength was increased from 100 to 200 for the response status

    • breaking

      removed the required property from the response with the status

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      endpoint deprecated

    • info

      for the path request parameter id, the type was generalized from string to no type

    • info

      the //// request property's maxLength was increased from 100 to 200

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status