---
title: "상쇄인증서 보관함 아이템 리스트"
method: GET
path: "/api/v2/certificatebox/item"
tags: ["CertificateBox"]
---

# 상쇄인증서 보관함 아이템 리스트

`GET /api/v2/certificatebox/item`

## Query parameters

- `sortType` 'AMOUNT_ASC' | 'AMOUNT_DESC' | 'ASC' | 'DESC' | 'NONE' | 'PRICE_ASC' | 'PRICE_DESC' | 'UNIT_PRICE_ASC' | 'UNIT_PRICE_DESC'
- `pageSize` integer, required
- `pageNum` integer, required

## Response `200`

OK

- WinclAggregationResponseCertificateBoxItemCertificateBoxAggregation
  - `aggregation` CertificateBoxAggregation
    - `currency` string — 통화
    - `totalCanceledAmount` number — 구매 취소한 수량
    - `totalLockedAmount` number — 잠긴 수량 (현재까지는 없음)
    - `totalOffsetAmount` number — 상쇄한 수량
    - `totalOffsetPrice` number — 상쇄한 총 탄소배출권 가격
    - `totalPurchasedAmount` number — 구매 수량
    - `totalReceivedAmount` number — 선물받은 수량
    - `totalSentAmount` number — 선물한 수량
    - `totalUsableAmount` number — 사용가능 수량 = 구매 - 상쇄 - 선물전송 + 선물수신
    - `totalUsablePrice` number — 보유한 총 탄소배출권 가격
    - `totalWholeAmount` number — 총 수량 = 사용가능 + 상쇄 + 선물전송 + 잠김 + 구매취소
    - `unitPrice` number — 탄소배출권 단위 가격
  - `code` string
  - `currentPageNum` integer — 현재 페이지 번호
  - `items` CertificateBoxItem[]
    - `certificateAgencyName` string — 인증기관 이름
    - `certificateVcCid` string — 인증서 VC CID
    - `certificateVcIssuedTimestamp` integer — 인증서 VC 최신 발급 타임스탬프(UTC epoch)
    - `certificateVcIssuing` boolean — 새 상쇄분이 반영된 VC가 발급 중인지 여부
    - `correspondanceAdjustmentRatio` number — 상응조정률
    - `currency` string — 통화
    - `nationCode` string — 프로젝트 생성국가
    - `nationEnglishName` string — 프로젝트 생성국가 영어 이름
    - `nationKoreanName` string — 프로젝트 생성국가 한글 이름
    - `offsetAmount` number — 상쇄한 수량
    - `offsetPrice` number — 상쇄한 탄소배출권 가격
    - `offsetTimestamp` integer — 상쇄 타임스탬프
    - `productName` string — 탄소배출권 상품 이름
    - `projectDeveloperName` string — 프로젝트 개발자이름
    - `projectEffect` string[] — 프로젝트 이펙트
    - `projectId` integer — 프로젝트 아이디
    - `projectName` string — 프로젝트 이름
    - `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' — 프로젝트 타입
    - `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

---

[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/revisions/662edcbbf2b3/schema)