---
title: "Get warehouse reservations"
method: GET
path: "/organizations/{id}/warehouse/inventory/reservations"
tags: ["Organization warehouse"]
---

# Get warehouse reservations

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

## Request

- Base URL: `https://api.carbonregistry.com`
- URL: `https://api.carbonregistry.com/organizations/{id}/warehouse/inventory/reservations`
- Auth: none declared
- TypeScript: <https://skmtc.dev/carbonregistry/apis/carbon-registry-rest-api/docs/organizations/:id/warehouse/inventory/reservations/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint returns a paginated list of ALL of the organization's warehouse reservations. Both active, expired and finished.

## Path parameters

- `limit` number, required
- `page` number, required
- `id` string, required

## Headers

- `x-icr-api-version` string

## Response `200`

- ReservationsResponseDto
  - `pagination` ApiPaginationDto, required
    - `total` number, required: Total number of items
    - `currentPage` number, required: Current page number
    - `pageCount` number, required: Total number of pages
    - `nextPage` number: Next page number
    - `prevPage` number: Previous page number
  - `reservations` ApiReservationDto[], required
    - `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
    - `createdAt` string, date-time, required: The creation date of the reservation
    - `state` string, required: The state of the reservation - if undefined the reservation is still waiting to be actived / finished.
    - `retirementId` string: The retirement ID of the reservation
    - `updatedAt` string, date-time, required: The update date of the reservation
    - `tokenId` string, required: The token ID of the reservation
    - `tokenAddress` string, required: The token address of the reservation
    - `type` 'exPost' | 'exAnte', required: The type of the reservation
    - `reservedToDate` string, date-time, required: The reserved to date of the reservation
    - `isComplete` boolean, required: The completion status of the reservation
    - `project` ApiProject, required
      - `id` string, required: The ID of the project
      - `fullName` string, required: The full name of the project
      - `url` string, required: The URL of the project
      - `publicUrl` string, required: The public URL of the project
      - `num` number, required: Project number. This is a unique identifier for the project
    - `reserver` ApiReserver, required
      - `id` string, required: The ID of the reserver
      - `name` string, required: The name of the reserver

---

[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)