---
title: "상쇄인증서 보관함 아이템 상세정보"
method: GET
path: "/api/v2/certificatebox/item/{id}"
tags: ["CertificateBox"]
---

# 상쇄인증서 보관함 아이템 상세정보

`GET /api/v2/certificatebox/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

## Response `200`

OK

- WinclAggregationResponseCertificateBoxItemEntryCertificateBoxItemAggregation
  - `aggregation` CertificateBoxItemAggregation
    - `certificateAgencyName` string — 인증기관 이름
    - `certificateVcCid` string — 인증서 VC CID
    - `certificateVcIssuedTimestamp` integer — 인증서 VC 최신 발급 타임스탬프(UTC epoch)
    - `certificateVcIssuing` boolean — 새 상쇄분이 반영된 VC 발급 진행 여부
    - `correspondanceAdjustmentRatio` number — 상응조정률
    - `creditSerialPrefix` string — 탄소배출권 시리얼 시작 문자열
    - `currency` string — 통화
    - `expireTimestamp` integer — 유효 시간
    - `firstOffsetTimestamp` integer — 첫번째 상쇄일시
    - `lastOffsetTimestamp` integer — 마지막 상쇄일시
    - `nationCode` string — 프로젝트 생성국가
    - `nationEnglishName` string — 프로젝트 생성국가 영어 이름
    - `nationKoreanName` string — 프로젝트 생성국가 한글 이름
    - `offsetAmount` number — 상쇄한 수량
    - `productName` string — 탄소배출권 상품 이름
    - `projectDeveloperName` string — 프로젝트 개발자이름
    - `projectEffect` string[] — 프로젝트 이펙트
    - `projectId` integer — 프로젝트 아이디
    - `projectName` string — 프로젝트 이름
    - `projectRegistrationTimestamp` integer — 프로젝트 인증 시간
    - `projectThumbnailUrl` string — 프로젝트 이미지
    - `projectTopicId` string — 프로젝트 토픽 ID
    - `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' — 프로젝트 타입
    - `unitPrice` number — 탄소배출권 단위 가격
    - `usablePrice` number — 상쇄한 탄소배출권 가격
  - `code` string
  - `currentPageNum` integer — 현재 페이지 번호
  - `items` CertificateBoxItemEntry[]
    - `blockchainPurchaseStatus` string — 블록체인에 기록된 구매 상태
    - `blockchainTransactionHash` string — 블록체인 트랜잭션 해쉬
    - `blockchainTransactionType` string — 블록체인 트랜잭션 종류: [MINT, TRANSFER, OFFSET]
    - `creditId` string — 탄소배출권 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' — 트랜잭션 타입
    - `unitPrice` 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)