---
title: "Post Removal"
method: POST
path: "/removals"
deprecated: true
---

# Post Removal

`POST /removals`

> **Deprecated.**

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Request body

- CreateRemovalRequest — Input to the POST /removals endpoint that creates a single removal
  - `supplier_reference_id` string, 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_on` string, date, required — The date at which activities related to this removal started.
  - `completed_on` string, date, required — The date by which activities related to this removal finished.
  - `steps` CreateRemovalStep[], nullable — Deprecated, please use the `removal_template_components` field instead. A list of steps to be included in the removal. The steps must match the steps defined in the process key. See the /processes endpoint to find which steps must be used.
    - `process_step_key` string, required — The key of the process step that this model corresponds to
    - `components` CreateRemovalComponentLink[], required — List of components that represent emissions, counterfactuals or sequestrations
      - `component_id` string, required — Isometric ID of the component to include within this removal step
      - `attribution_factor_datapoint_id` string, nullable — A scalar between 0 and 1 for the fraction of the CO2e flux of the component that is to be attributed to this removal. A null input will default to 1.
  - `process_key` string, nullable — Deprecated, please use the `removal_template_id` field instead. The key of the process to be used. See the processes endpoint for the processes available.
  - `project_id` string, required — The ID of the project to associate this removal to.
  - `feedstock_type_id` string, nullable — The ID of the feedstock type that will be used for this removal.
  - `removal_template_id` string, nullable — This field will become required once the deprecated `process_key` field is removed. ID of the removal template to instantiate the removal from.
  - `removal_template_components` RemovalTemplateComponentInputs[]
    - `removal_template_component_id` string, required — The ID of the removal template component to provide
    - `inputs` union[], required — A list of values for component inputs. Inputs and their keys can be found on the removal template at the `GET /projects/{project_id}/removal_templates` endpoint.
      - union
        - CreateComponentListInput
          - `__typename` 'CreateComponentListInput' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
          - `input_key` string, required — An input key from the component blueprint.
          - `datapoint_ids` string[], required — The Isometric IDs of the datapoints that will be used to populate the value of this input
        - CreateComponentScalarInput
          - `__typename` 'CreateComponentScalarInput' — Contains the name of the model (formally, OpenAPI Schema Object). Used to determine the type of data, for example when two different types are unioned.
          - `input_key` string, required — An input key from the component blueprint.
          - `datapoint_id` string, required — The Isometric ID of the datapoint that will be used to populate the value of this input

## Response `200`

Successful Response

- Removal
  - `id` string, required
  - `supplier_reference_id` string, 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_on` string, date, required
  - `completed_on` string, date, required
  - `co2e_net_removed_kg` number, required — The CO₂e removed by this removal once uncertainty discounting has been applied
  - `co2e_net_removed_without_discount_kg` number, required — The CO₂e removed by this removal before any uncertainty discounting has been applied
  - `co2e_net_removed_standard_deviation_kg` number, nullable, required — The standard deviation of the CO₂e net removed and therefore the uncertainty discount applied to the removal
  - `ghg_statement_id` string, 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_id` string, nullable, required — The feedstock type ID that this removal is associated with.
  - `risk_of_reversal_percentage` number, nullable, required — The percentage of credits contributed to the buffer pool due to risk of reversal.
  - `credit_allocation` CreditAllocation, required
    - `buffer_pool_contribution_kg` integer, required — The number of credits (in kg CO₂e) contributed to the buffer pool, computed as risk_of_reversal_percentage × total issuable credits.
    - `supplier_allocation_kg` integer, required — The number of credits (in kg CO₂e) issued to the supplier, computed as total issuable credits minus buffer pool contribution.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-certify-data-ingestion-api/versions/9819e9c8ccf0/schema)