> 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/api-en/back-office-api-reference/marketing-bo-api/mileage-expiration-management.md).

# Mileage Expiration Management

## Manual Mileage Expiration Processing

> \## Function Description\
> \* Manually processes the expiration of paid mileage.\
> \---\
> \## Detailed Description\
> \* Manually processes the expiration of mileage that was paid in error.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204: Mileage accrual expiration processing<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgExtctRequest":{"type":"object","description":"Mileage Expiration Processing Request","properties":{"astMgrSeqList":{"type":"array","description":"Asset Management Sequence No. List","items":{"type":"string"}},"astMgrMemo":{"type":"string","description":"Expiration Reason"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgExtctMgmt/saveMilgExtct":{"post":{"tags":["Mileage Expiration Management"],"summary":"Manual Mileage Expiration Processing","description":"## Function Description\n* Manually processes the expiration of paid mileage.\n---\n## Detailed Description\n* Manually processes the expiration of mileage that was paid in error.\n---\n## Revision History\n* Release v1.05_231204: Mileage accrual expiration processing\n","operationId":"saveMilgExtct_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgExtctRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Mileage History

> \## Function Description\
> \* Retrieves mileage history.\
> \---\
> \## Detailed Description\
> \* Retrieves mileage history for manual mileage expiration processing.\
> \* Retrieves mileage history matching the search conditions. The search conditions are as follows.\
> &#x20;  \* Reference date\
> &#x20;  \* Search type (All, Accrual, Usage)\
> &#x20;  \* Member information (member name, member ID, member number)\
> &#x20;  \* Asset management number\
> \---\
> \## Revision History\
> \* Release v1.05\_231204: Retrieve Mileage Accrual History\
> \* Release v2.00\_240530: Changed date search query\
> \---\
> \## Code Summary\
> \* Member information (mbrOpt): Member Name (NAME), Member ID (ID), Member Number (MBRNO)\
> \* Search type (condxAstRsrvUseGbOpt): All (ALL)<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgExtctMgmtRequest":{"type":"object","description":"Mileage Management Request","properties":{"condxMbrOpt":{"type":"string","description":"Search Type (Member Name/Member ID/Member No.)"},"condxMbrValue":{"type":"string","description":"Search Type Value"},"condxAstRsrvUseGbOpt":{"type":"string","description":"Accrual/Usage Classification Code (ME016)"},"condxAstRsrvUseCausOpt":{"type":"string","description":"Asset Accrual/Usage Reason Type (ME020)"},"condxAstMgrNo":{"type":"string","description":"Asset Management No."},"frDt":{"type":"string","format":"date","description":"Search Period - Start"},"toDt":{"type":"string","format":"date","description":"Search Period - End"},"dateSelect":{"type":"string","description":"Search Period Option"},"sysRegUserId":{"type":"string","description":"Registrant ID"}}},"MilgExtctMgmtResponse":{"type":"object","properties":{"astMgrSeq":{"type":"string","description":"Asset Management Sequence No."},"mbrNo":{"type":"string","description":"Member No."},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Login ID"},"astRsrvUseGbCd":{"type":"string","description":"Asset Accrual/Usage Classification Code (ME016)"},"astRsrvUseGbNm":{"type":"string","description":"Asset Accrual/Usage Type Code Name (ME016)"},"astRsrvUseCausNm":{"type":"string","description":"Asset Accrual/Usage Reason Code Name (ME020)"},"astMgrNo":{"type":"string","description":"Asset Management No."},"ocurAmt":{"type":"number","description":"Amount Incurred"},"balAmt":{"type":"number","description":"Remaining Amount"},"valiStrDt":{"type":"string","description":"Validity Start Date"},"valiEndDt":{"type":"string","description":"Validity End Date"},"astMgrMemo":{"type":"string","description":"Asset Management Memo"},"sysRegId":{"type":"string","description":"System Registrant ID"},"sysRegDtm":{"type":"string","format":"date-time","description":"System Registration Date/Time"},"sysModId":{"type":"string","description":"System Modifier ID"},"sysModDtm":{"type":"string","format":"date-time","description":"System Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgExtctMgmt/getMilgExtctMgmtList":{"get":{"tags":["Mileage Expiration Management"],"summary":"Retrieve Mileage History","description":"## Function Description\n* Retrieves mileage history.\n---\n## Detailed Description\n* Retrieves mileage history for manual mileage expiration processing.\n* Retrieves mileage history matching the search conditions. The search conditions are as follows.\n   * Reference date\n   * Search type (All, Accrual, Usage)\n   * Member information (member name, member ID, member number)\n   * Asset management number\n---\n## Revision History\n* Release v1.05_231204: Retrieve Mileage Accrual History\n* Release v2.00_240530: Changed date search query\n---\n## Code Summary\n* Member information (mbrOpt): Member Name (NAME), Member ID (ID), Member Number (MBRNO)\n* Search type (condxAstRsrvUseGbOpt): All (ALL)\n","operationId":"getMilgEtctMgmtList_1","parameters":[{"name":"milgExtctMgmtRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgExtctMgmtRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgExtctMgmtResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## Retrieve Mileage History Count

> \## Function Description\
> \* Retrieves the total count of the mileage history list.\
> \---\
> \## Detailed Description\
> \* Retrieves the total count of the mileage history list by search condition.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204: Retrieve mileage accrual history count\
> \* Release v2.00\_240530: Changed date query\
> \---\
> \## Code Reference\
> \* Member Information (mbrOpt) : Member Name (NAME), Member ID (ID), Member No. (MBRNO)\
> \* Search Type (condxAstRsrvUseGbOpt) : All (ALL)<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgExtctMgmtRequest":{"type":"object","description":"Mileage Management Request","properties":{"condxMbrOpt":{"type":"string","description":"Search Type (Member Name/Member ID/Member No.)"},"condxMbrValue":{"type":"string","description":"Search Type Value"},"condxAstRsrvUseGbOpt":{"type":"string","description":"Accrual/Usage Classification Code (ME016)"},"condxAstRsrvUseCausOpt":{"type":"string","description":"Asset Accrual/Usage Reason Type (ME020)"},"condxAstMgrNo":{"type":"string","description":"Asset Management No."},"frDt":{"type":"string","format":"date","description":"Search Period - Start"},"toDt":{"type":"string","format":"date","description":"Search Period - End"},"dateSelect":{"type":"string","description":"Search Period Option"},"sysRegUserId":{"type":"string","description":"Registrant ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgExtctMgmt/getMilgExtctMgmtListCount":{"get":{"tags":["Mileage Expiration Management"],"summary":"Retrieve Mileage History Count","description":"## Function Description\n* Retrieves the total count of the mileage history list.\n---\n## Detailed Description\n* Retrieves the total count of the mileage history list by search condition.\n---\n## Revision History\n* Release v1.05_231204: Retrieve mileage accrual history count\n* Release v2.00_240530: Changed date query\n---\n## Code Reference\n* Member Information (mbrOpt) : Member Name (NAME), Member ID (ID), Member No. (MBRNO)\n* Search Type (condxAstRsrvUseGbOpt) : All (ALL)\n","operationId":"getMilgEtctMgmtListCount","parameters":[{"name":"milgExtctMgmtRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgExtctMgmtRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```