# API 3: Get POS & Terminal Binding List

### Through this API interface, you will be able to obtain a list of POS under the current merchant ID along with the bound payment terminals.



## Get POS & Terminal Binding List

<mark style="background-color:blue;">**Test Enviroment:**</mark>

<mark style="color:green;">`POST`</mark> [https://oversea.paywizard.biz/ovstrade/semiOpen/V3/queryTerminalList](https://oversea.paywizard.biz/ovstrade/semiOpen/V3/queryTerminalList)

<mark style="background-color:green;">**Production Enviroment:**</mark>

<mark style="color:green;">`POST`</mark> [https://portal.paywizard.biz/ovstrade/semiOpen/V3/queryTerminalList ](https://portal.paywizard.biz/ovstrade/semiOpen/V3/queryTerminalList)

**Headers**

| Name         | Value                                                                                                         |
| ------------ | ------------------------------------------------------------------------------------------------------------- |
| Content-Type | `application/json`                                                                                            |
| jwt-token    | Merchant Token provided by Paywizard                                                                          |
| sign         | [paywizard-open-platform-api-signature-guide-v3](../paywizard-open-platform-api-signature-guide-v3 "mention") |

**Request Body**

<table><thead><tr><th>Name</th><th>Type</th><th data-type="checkbox">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>clientId</td><td>string</td><td>true</td><td>Developer ID</td></tr><tr><td>merchantId</td><td>String</td><td>true</td><td>Merchant ID</td></tr></tbody></table>

**Request Sample**

```json
{
    "clientId": "client12345",
    "merchantId": "10800000003",
}
```

**Response Body**

<table><thead><tr><th>Name</th><th>Type</th><th data-type="checkbox">Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>int</td><td>true</td><td><p>Response Code</p><p><code>(200 Success,</code></p><p><code>Non-200 Failed)</code></p></td></tr><tr><td>msg</td><td>String</td><td>true</td><td>Response Message</td></tr><tr><td>timestamp</td><td>String</td><td>true</td><td>Date/Time(UTC)</td></tr><tr><td>data</td><td>Object</td><td>true</td><td>Response Data</td></tr><tr><td>-terminalId</td><td>String</td><td>true</td><td>Terminal ID</td></tr><tr><td>-terminalSn</td><td>String</td><td>true</td><td>Terminal S/N</td></tr><tr><td>-bindPosId</td><td>String</td><td>true</td><td>Binding POS ID</td></tr></tbody></table>

**Response Sample**

{% tabs %}
{% tab title="200" %}
```json
{
    "code": 200,
    "msg": "200",
    "data": [
        {
            "terminalId": "12212024123456",
            "terminalSn": "WP2024123456",
            "bindPosId": "POS123456"
        }
    ],
    "timestamp": "2024-07-23 17:57:00"
}
```
{% endtab %}
{% endtabs %}
