> For the complete documentation index, see [llms.txt](https://workspace-help.nhn-commerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://workspace-help.nhn-commerce.com/aurora-guide/api-1/mypage-benefit/accumulation-list.md).

# 적립금

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

기본 스킨에서는 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)
>
> ▶ 적립금 요약 조회하기\
> 등록된 프로모션 코드를 입력하여 회원에게 쿠폰을 발급합니다.