---
title: "탄소배출권 보관함 아이템 상세정보"
method: GET
path: "/api/v2/creditbox/item/{id}"
tags: ["CreditBox"]
---

# 탄소배출권 보관함 아이템 상세정보

`GET /api/v2/creditbox/item/{id}`

## Path parameters

- `id` integer, required

## Query parameters

- `sortType` 'AMOUNT_ASC' | 'AMOUNT_DESC' | 'ASC' | 'DESC' | 'NONE' | 'PRICE_ASC' | 'PRICE_DESC' | 'TRANSACTION_TYPE_ASC' | 'TRANSACTION_TYPE_DESC' | 'UNIT_PRICE_ASC' | 'UNIT_PRICE_DESC'
- `pageSize` integer, required
- `pageNum` integer, required
- `transactionTypes` 'OFFSET' | 'PURCHASE' | 'PURCHASE_CANCEL' | 'RECEIVE' | 'SEND' | 'SEND_CANCEL' | 'UNSPECIFIED'

## Response `200`

OK

- WinclAggregationResponseCreditBoxItemEntryCreditBoxItemAggregation
  - `aggregation` CreditBoxItemAggregation
    - `canceledAmount` number — 구매 취소한 수량
    - `certificateAgencyName` string — 인증기관 이름
    - `correspondanceAdjustmentRatio` number — 상응조정률
    - `currency` string — 통화
    - `expireTimestamp` integer — 유효 시간
    - `lockedAmount` number — 잠긴 수량 (현재까지는 없음)
    - `nationCode` string — 프로젝트 생성국가
    - `nationEnglishName` string — 프로젝트 생성국가 영어 이름
    - `nationKoreanName` string — 프로젝트 생성국가 한글 이름
    - `offsetAmount` number — 상쇄한 수량
    - `productName` string — 탄소배출권 상품 이름
    - `projectDeveloperName` string — 프로젝트 개발자이름
    - `projectEffect` string[] — 프로젝트 이펙트
    - `projectId` integer — 프로젝트 아이디
    - `projectName` string — 프로젝트 이름
    - `projectRegistrationTimestamp` integer — 프로젝트 인증 시간
    - `projectThumbnailUrl` string — 프로젝트 이미지
    - `projectType` 'AFFORESTATION_REFORESTATION_AND_REVEGETATION' | 'AGRICULTURAL_LAND_MANAGEMENT' | 'AGRICULTURE_FORESTRY_AND_OTHER_LAND_USE' | 'AVOIDED_CONVERSION_OF_GRASSLANDS_AND_SHRUBLANDS' | 'CHEMICAL_INDUSTRY' | 'CLIMATE_CHANGE_ADAPTION' | 'CONSTRUCTION' | 'ENERGY' | 'ENERGY_DEMAND' | 'ENERGY_DISTRIBUTION' | 'ENERGY_INDUSTRIES' | 'FUGITIVE_EMISSIONS_FROM_FUELS__SOLID_OIL_AND_GAS' | 'IMPROVED_FOREST_MANAGEMENT' | 'LIVELIHOODS' | 'LIVESTOCK_ENTERIC_FERMENTATION_AND_MANURE_MANAGEMENT' | 'MANUFACTURING_INDUSTRIES' | 'METAL_PRODUCTION' | 'MINING_MINERAL_ODUCTION' | 'PLASTIC_WASTE_COLLECTION' | 'PLASTIC_WASTE_RECYCLING' | 'REDUCED_EMISSONS_FROM_FORESTATION_AND_DEGRADATION' | 'TRANSPORT' | 'UNSPECIFIED' | 'WASTE_HANDLING_AND_DISPOSAL' | 'WATER_ACCESS_AND_SANITATIO' | 'WETLAND_REWETTING_AND_CONSVATION' — 프로젝트 타입
    - `purchasedAmount` number — 구매 수량
    - `receivedAmount` number — 선물받은 수량
    - `sentAmount` number — 선물한 수량
    - `totalAmount` number — 총 수량 = 사용가능 + 상쇄 + 선물전송 + 잠김 + 구매취소
    - `unitPrice` number — 탄소배출권 단위 가격
    - `usableAmount` number — 사용가능 수량 = 구매 - 상쇄 - 선물전송 + 선물수신
    - `usablePrice` number — 사용가능한 탄소배출권 가격
  - `code` string
  - `currentPageNum` integer — 현재 페이지 번호
  - `items` CreditBoxItemEntry[]
    - `blockchainPurchaseStatus` string — 블록체인에 기록된 구매 상태
    - `blockchainTransactionHash` string — 블록체인 트랜잭션 해쉬
    - `blockchainTransactionType` string — 블록체인 트랜잭션 종류: [MINT, TRANSFER, OFFSET]
    - `creditId` string — credit id
    - `expectedExpirationDateTime` string, date-time — 예정된 유효기한 타임스탬프
    - `expectedExpirationTimestamp` integer — 예정된 유효기한 타임스탬프
    - `productCurrency` 'KRW' | 'USD' — 제품 기본 통화
    - `transactionAmount` number — 트랜잭션 수량
    - `transactionDateTime` string, date-time — 트랜잭션 일시
    - `transactionPrice` number — 금액
    - `transactionStatus` 'CANCELED' | 'PENDING' | 'RECEIVE' | 'SND_CANCEL' | 'SUCCESS' | 'UNSPECIFIED' — 트랜잭션 상태: [SUCCESS, PENDING, CANCELED, RECEIVE, SND_CANCEL]
    - `transactionTimestamp` integer — 트랜잭션 타임스탬프
    - `transactionType` 'OFFSET' | 'PURCHASE' | 'PURCHASE_CANCEL' | 'RECEIVE' | 'SEND' | 'SEND_CANCEL' | 'UNSPECIFIED' — 트랜잭션 타입
    - `transferable` boolean — 선물 가능 여부
    - `unitPrice` number — 제품 단위 가격
    - `usableAmount` number — 사용가능한 수량
  - `message` string
  - `pageSize` integer — 페이지당 아이템 개수
  - `sortType` 'AMOUNT_ASC' | 'AMOUNT_DESC' | 'ASC' | 'DESC' | 'NONE' | 'PRICE_ASC' | 'PRICE_DESC' | 'UNIT_PRICE_ASC' | 'UNIT_PRICE_DESC' — 정렬 기준
  - `totalCount` integer — 전체 아이템 개수
  - `totalPages` integer — 전체 페이지 수

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `915` — ITEM_NOT_FOUND

---

[API](https://skmtc.net/wincl/apis/wincl-api.md) · [All operations](https://skmtc.net/wincl/apis/wincl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wincl/wincl-api/versions/662edcbbf2b3/schema)