# 마일리지

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

다음 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))\
  마일리지 정보를 요약하여 조회합니다.

```
POST /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 
```


---

# 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://tech.x2bee.com/api-guide/store-front-api/undefined-4/undefined-3.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.