---
# System prepended metadata

title: 'Project: bo MMR player tier & rp & other query'

---

# Project: bo MMR player tier & rp & other query
# 📁 Collection: MMR player tier 


---
## End-point: MMR player tier
### Method: GET
>```
>{{host}}/player-tiers?walletAddress=aa,bb,cc&seasonFrom=1&seasonTo=12
>```
### Query Params


|query Param|value|
|---|---|
|walletAddress|aa,bb,cc [array string]|
|seasonIdStart|1|
|seasonIdEnd|12|

|list Param|value|
|---|---|
|page|1|
|pageSize|100|
|sortBy|updatedAt<br/>seasonStartDateTime<br/>walletAddress<br/>playerName<br/>week1<br/>week2<br/>week3<br/>week4 <br/>week5<br/>註:<br/>1.sortBy 不傳就是 Default sort<br/>2.格式:fieldName asc\|desc|


Default sort
a) **Season Start DateTime** DESC
b) **Current Week Tier level** DESC




### 🔑 Authentication bearer

|Param|value|Type|
|---|---|---|
|token|{{token}}|string|


### Response: 200
```json
{
    "pageSize":100,
    "page":1,
    "totalRows":200,
    "results":[
        {
            "seqNo":1,
            "seasonId":1,
            "walletAddress":"0xAAA",
            "playerName":"ABC",
            "seasonStartDateTime":"2023-02-06T09:39:42.284Z",
            "seasonEndDateTime":"2023-02-06T09:39:42.284Z",
            "week1":"xxx",
            "week2":"xxx",
            "week3":"xx",
            "week4":"xx",
            "week5":"N/A",
            "updatedAt":"",
            "updatedBy":"",
            "nextReshuffleDateTime":"2023-02-06T09:39:42.284Z",
            "lastReshuffleDateTime":"2023-02-06T09:39:42.284Z",
        }
    ]
    
}
```

---

## End-point: MMR player tier - detail
### Method: GET
>```
>{{host}}/player-tiers/:id/:week
>```
### Query Params

|Param|value|
|---|---|
|:id|1|
|:week|1~5|


### 🔑 Authentication bearer

|Param|value|Type|
|---|---|---|
|token|{{token}}|string|


### Response: 200
```json
{
    "result":{
        "currentWeekDateTimeFrom": "2023-02-06T09:39:42.284Z",
        "currentWeekDateTimeTo": "2023-02-06T09:39:42.284Z",
        "walletAddress":"0xAAA",
        "playerName":"xxx",
        "playerTier":"Master",
        "playerRankingPoint":"3700",
        "playerRewardsLastWeek":500, //"OPL"
        "playerMatchesWin": 7,
        "playerMatchesLose": 3,
        "updatedAt":"2023-02-06T09:39:42.284Z",
        "updatedBy":"system",
    },
}

```


## End-point: MMR player tier - season list
### Method: GET
>```
>{{host}}/player-tiers/seasons?limit=12
>```
### Query Params

|Param|value|
|---|---|
|limit|12|

*註: 本季再向前推 12 season.

### 🔑 Authentication bearer

|Param|value|Type|
|---|---|---|
|token|{{token}}|string|


### Response: 200
```json
{
    "results": [
      {
        "seasonId": 1,
        "seasonName": "season 1"
      },
      {
        "seasonId": 2,
        "seasonName": "season 2"
      },
      {
        "seasonId": 3,
        "seasonName": "season 3"
      },
      {
        "seasonId": 4,
        "seasonName": "season 4"
      },
      {
        "seasonId": 5,
        "seasonName": "season 5"
      },
      {
        "seasonId": 6,
        "seasonName": "season 6"
      },
      {
        "seasonId": 7,
        "seasonName": "season 7"
      },
      {
        "seasonId": 8,
        "seasonName": "season 8"
      },
      {
        "seasonId": 9,
        "seasonName": "season 9"
      },
      {
        "seasonId": 10,
        "seasonName": "season 10"
      },
      {
        "seasonId": 11,
        "seasonName": "season 11"
      },
      {
        "seasonId": 12,
        "seasonName": "season 12"
      },
      {
        "seasonId": 13,
        "seasonName": "season 13"
      }
    ]
}
```

### --統一錯誤反饋--

### Error response: 400
```json
{
    "message": "error"
}
```