> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front-api/undefined-4/undefined-3.md).

# 마일리지

고객의 마일리지를 조회하고 사용하는 기능을 제공합니다.

다음 API를 활용하여 고객은 적립된 마일리지를 확인하고, 구매 여정에서 마일리지를 사용하여 할인 혜택을 받을 수 있습니다.

또한 마일리지 사용 내역을 조회하고 관리할 수 있습니다.

***

## 마일리지 조회 <a href="#plus" id="plus"></a>

마이페이지 전체 메뉴에서 마일리지를 클릭하면 마일리지 페이지로 이동합니다.

마일리지는 잔여 마일리지 요약정보와, 상세조회 API를제공합니다.

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266111035/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80.drawio.png" alt=""></p>

### 1. 마일리지 요약 조회 <a href="#id-1" id="id-1"></a>

* **보유 마일리지 요약 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80\&path=getMlgBalAmtInfo))\
  마일리지 정보를 요약하여 조회합니다.

```
GET /v1/mileage/mlgSum 
```

### 2. 마일리지 사용/적립 내역 보기 <a href="#id-2" id="id-2"></a>

마일리지의 사용 내역과 적립 내역을 지정된 조회 기간으로 조회하거나, 날짜를 지정하여 조회할 수 있습니다.

* **마일리지 사용/적립 목록 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80\&path=getMlgDtlList))\
  마일리지 조회 시 사용 과 적립으로 구분하여 호출하며, 검색 가능 기간은 검색 시작일로부터 최대 3개월 까지 조회가 가능합니다.

```
GET /v1/mileage/mlgDtlList 
```