---
title: "받은 선물 리스트"
method: GET
path: "/api/v1/wallet/gift/received"
tags: ["Wallet"]
---

# 받은 선물 리스트

`GET /api/v1/wallet/gift/received`

## Query parameters

- `pageSize` integer, required
- `pageNum` integer, required

## Response `200`

OK

- WinclAggregationResponseReceivedGiftReceivedGiftHistoryAggregation
  - `aggregation` ReceivedGiftHistoryAggregation
    - `currency` 'KRW' | 'USD' — 통화
    - `totalGiftPrice` number — 선물받은 총 탄소배출권 가격
    - `totalReceivedAmount` number — 선물받은 총 탄소배출권 양 (톤)
  - `code` string
  - `currentPageNum` integer — 현재 페이지 번호
  - `items` ReceivedGift[]
    - `amt` number — 선물 수량
    - `blockchainTransactionHash` string — 블록체인 트랜잭션 해쉬; blockchainTransactionStatus=PENDING이면 null
    - `blockchainTransactionStatus` string — 블록체인 동기화 상태
    - `dttm_receive` integer — 수령 일시
    - `dttm_send` integer — 발송 일시
    - `email_send` string — 보낸 유저의 이메일
    - `id_gift` string — 받은 선물 id
    - `id_login_send` string
    - `id_prod` string — 탄소배출권 ID
    - `id_usr_prod_rcv` string
    - `id_usr_send` string — 보낸 유저 아이디
    - `nm_prod` string — 탄소배출권 이름
    - `projectId` string — 사업 프로젝트 ID
    - `status` 'AUTO_CANCEL' | 'PENDING' | 'RECEIVE' | 'SND_CANCEL' — 받은 선물 상태
    - `tp_transfer` 'COUPON' | 'EMAIL' | 'PHONE' — 선물 받은 타입 (eamil, phone)
  - `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)