---
title: "Reserve credits from warehouse"
method: POST
path: "/organizations/{id}/warehouse/inventory/reservations"
tags: ["Organization warehouse"]
---

# Reserve credits from warehouse

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

This endpoint reserves credits from the organization warehouse. They are reserved for 10 minutes. In the meantime the reserver can be sure that the credits are available for them. This is especially useful for marketplaces that don't want the extra complexity of custody-ing user's credits.

## Path parameters

- `id` string, required

## Query parameters

- `development` string, required

## Headers

- `x-icr-api-version` string

## Request body

- ReserveWarehouseInventoryRequestDto
  - `amount` number, required — The amount of credits to reserve
  - `creditId` string, required — The id of the credit to reserve

## Response `200`

- ApiBaseReservationDto
  - `id` string, required — The unique identifier of the reservation, used to finish / cancel it
  - `creditId` string, required — The unique identifier of the credit
  - `serialization` string, required — The serialization of the reservation
  - `amount` number, required — The amount reserved

---

[API](https://skmtc.net/carbonregistry/apis/carbon-registry-rest-api.md) · [All operations](https://skmtc.net/carbonregistry/apis/carbon-registry-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonregistry/carbon-registry-rest-api/revisions/a9f1b102faca/schema)