---
title: "Finish warehouse reservation"
method: POST
path: "/organizations/{id}/warehouse/inventory/reservations/{reservationId}/{action}"
tags: ["Organization warehouse"]
---

# Finish warehouse reservation

`POST /organizations/{id}/warehouse/inventory/reservations/{reservationId}/{action}`

## Request

- Base URL: `https://api.carbonregistry.com`
- URL: `https://api.carbonregistry.com/organizations/{id}/warehouse/inventory/reservations/{reservationId}/{action}`
- Auth: none declared

This endpoint finishes a specific warehouse reservation. This moves the credits out of the organization's warehouse and into the receiver's wallet, either as retired credits or the credits themselves.

## Path parameters

- `id` string, required
- `reservationId` string, required
- `action` 'transfer' | 'transfer_retire', required

## Headers

- `x-icr-api-version` string

## Request body

- TransferReservedWarehouseInventoryRequestDto
  - `priceInfo` PriceInfo
    - `price` number, required: The price of each credit, tCO2
    - `currency` string, required: The currency of the price using ISO 4217 codes
  - `receiverId` string: The id of organization that will be receiving the credits
  - `receiverAddress` string: The wallet address that will be receiving the credits
  - `transferComment` string: Comment for the transfer
  - `retirementData` RetirementData
    - `reason` string, required: The reason for the retirement
    - `beneficiaryName` string, required: The beneficiary name
    - `comment` string, required: Comment for the retirement

## Response `200`

- FinisheWarehouseReservationResponse
  - `success` boolean, required
  - `transactionId` string, required
  - `state` 'processed' | 'failed' | 'pending_queue' | 'pending_onchain' | 'pending_request' | 'rejected' | 'pending_reserved' | 'cancelled', required: The state of the transaction - usually this will be pending_queue in this response and you'll need to query / poll the reservation or transaction endpoint to know whether the transaction failed to process or not.

---

[API](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api.md) - [All operations](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/revisions/a9f1b102faca?raw)