# 적립금

회원이 보유한 적립금 리스트를 제공합니다. 

기본 스킨에서는 1개의 적립금 리스트에서 '지급된 적립금'과 '차감된 적립금'이 각 행으로 제공되고 있습니다.\
지급/차감이 실행된 일시와 지급/차감 사유가 노출되는 내용 영역, 지급/차감 금액, 적립금의 유효기간(있는 경우)이 출력됩니다.

<figure><img src="/files/vLa5R4jjpRLaHvAhV8AD" alt=""><figcaption></figcaption></figure>

> [GET /profile/accumulations](https://docs.shopby.co.kr/?url.primaryName=manage/#/Accumulation/search-accumulation-histories)
>
> ▶ 적립금 이력 조회하기\
> 회원의 적립금 내역을 모두 조회합니다.

response 스키마 내 <mark style="background-color:yellow;">accumulationStatusGroupType</mark> 의 값에 따라 지급/차감 여부를 구분 할 수 있으며, \
적립 사유는 <mark style="background-color:yellow;">accumulationReserveReason</mark> 코드를 통해 확인 할 수 있습니다.

유효기간은 <mark style="background-color:yellow;">registerYmdt</mark>\~ <mark style="background-color:yellow;">expireYmdt</mark> 의 값에 따라 출력하시면 됩니다.

api 명세서상 `expireYmdt`(만료일)이 9999년 일때 `제한없음`으로 표기됩니다.

회원의 적립금 요약 내용(사용 가능한 총 적립금, 만료된 총 적립금)을 조회 하기 위해서는 아래의 API를 통해 확인 가능합니다.

> [GET /profile/accumulations/summary](https://docs.shopby.co.kr/?url.primaryName=manage/#/Accumulation/search-accumulations-summary)
>
> ▶ 적립금 요약 조회하기\
> 등록된 프로모션 코드를 입력하여 회원에게 쿠폰을 발급합니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://workspace-help.nhn-commerce.com/aurora-guide/api-1/mypage-benefit/accumulation-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.