> For the complete documentation index, see [llms.txt](https://smartpossdk.gitbook.io/paywizard-open-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartpossdk.gitbook.io/paywizard-open-api/cloud-api/pos-and-payment-terminal-binding-process/api-get-pos-and-terminal-binding-list.md).

# API: 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://uat.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>

**Headers**

| Name         | Value                                                                                                                             |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| Content-Type | `application/json`                                                                                                                |
| jwt-token    | Merchant Token provided by Paywizard in merchant token Email                                                                      |
| sign         | [PayWizard Open Platform API Signature Guide V3](/paywizard-open-api/cloud-api/paywizard-open-platform-api-signature-guide-v3.md) |

**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 %}