---
title: "Get organization inventory requests"
method: GET
path: "/organizations/{id}/inventory/requests"
tags: ["Organizations"]
---

# Get organization inventory requests

`GET /organizations/{id}/inventory/requests`

This endpoint returns a paginated list of the organization's inventory requests

## Path parameters

- `limit` number, required
- `page` number, required
- `id` string, required
- `states` string[], required

## Headers

- `x-icr-api-version` string

## Response `200`

- CreditRequestsResponseDto
  - `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
  - `creditRequests` ApiCreditRequestDto[], required
    - `action` 'transfer' | 'retire' | 'transfer_retire' | 'cancel' | 'issuance' | 'receive' | 'claim' | 'create_project' | 'create_vintages', required — Action of the credit request
    - `type` 'exAnte' | 'exPost' | 'retirementCertificate', required — Type of the credit request
    - `id` string, required — ID of the credit request
    - `toAddress` string — Address of the recipient of the credit request
    - `createdAt` string, date-time, required — Timestamp of when the credit request was created
    - `updatedAt` string, date-time, required — Timestamp of when the credit request was last updated
    - `tokenId` string, required — ID of the token associated with the credit request
    - `tokenAddress` string, required — Address of the token associated with the credit request
    - `creditId` string, required — ID of the credit associated with the credit request
    - `serialization` string, required — Serialization of the credit request
    - `vintage` string, required — The vintage year of the credit
    - `amount` number, required — Amount of the credit request
    - `fromOrganizationId` string, required — ID of the organization sending the credit request
    - `toOrganizationId` string — ID of the organization receiving the credit request
    - `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
    - `txId` string — ID of the transaction associated with the credit request
    - `state` 'processed' | 'failed' | 'pending_queue' | 'pending_onchain' | 'pending_request' | 'rejected' | 'pending_reserved' | 'cancelled', required — State of the credit request: cancelled | failed | pending_onchain | pending_queue | pending_request | pending_reserved | processed | rejected
    - `transactionData` TransactionDataDto
      - `creditId` string, required — The id of the credit
      - `tokenId` string, required — The onchain token of the credit
      - `amount` number, required — The amount of this credit being moved
      - `serialization` string, required — The serialization of this credit
    - `retirementId` string — The retirement ID of the reservation
    - `retirementReason` string — Reason for retirement of the credit request
    - `retirementComment` string — Comment for retirement of the credit request
    - `beneficiaryName` string — Name of the beneficiary of the credit request

---

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