# Kiểm tra danh sách đại lý

<mark style="color:green;">**`GET`**</mark> API Get MID

```
https://<vietqr-host>/<basepath>/api/mid/list-mid
```

**Headers**

<table><thead><tr><th width="283">Name</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr><tr><td>Authorization</td><td>Bearer &#x3C;token> Bạn nhận được khi gọi API Get Token của VietQR</td></tr></tbody></table>

**Request Param**

<table data-full-width="false"><thead><tr><th width="197">Name</th><th width="93">Type</th><th width="98">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>page</code></td><td>Integer</td><td>Optional</td><td>Giá trị trang muốn hiển thị (default = 1)</td></tr><tr><td><code>size</code></td><td>Integer</td><td>Optional</td><td>Giá trị số item tối đa hiển thị của page (default = 20)</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "metadata": {
        "page": 1,
        "size": 20,
        "totalPage": 1,
        "totalElement": 1
    },
    "data": [
        {
            "merchantIdentify": "MST/CCCD/ĐKKD",
            "mid": "ID_của_đại_lý",
            "merchantName": "tên_rút_gọn_đại_lý",
            "merchantFullName": "tên_đại_lý",
            "merchantAddress": "địa_chỉ_đại_lý",
            "contactEmail": "email_liên_hệ",
            "contactPhone": "điện_thoại_liên_hệ"
        }
    ]
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "status": "FAILED",
    "message": "mã_lỗi"
}
```

{% endtab %}
{% endtabs %}

***

### Code mẫu

{% tabs %}
{% tab title="cURL" %}

```
curl --location 'https://api.vietqr.org/vqr/api/mid/list-mid?page=page_cần_chọn&size=số_record_cần_hiển_thị_trong_1_lần&mid=id_của_đại_lý' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhdXRob3JpdGllcyI6WyJST0xFX1VTRVIiXSwidXNlciI6IlkzVnpkRzl0WlhJdGJtZDFlV1Z1TFhWelpYSXlORGt5IiwiaWF0IjoxNzIxMzc1MTUyLCJleHAiOjE3MjEzNzU0NTJ9.M-Yfnvm_mZGVteqoZ4aLdN2m_7_c8BwUHnzHm0WPOMW5ayTk49HWLtpl562AdgS_BUBUAS0648BktOaGzy6h8Q' \
--header 'Cookie: JSESSIONID=483ACB24C22E803DCFB52C2D89CCB4B0'
```

{% endtab %}
{% endtabs %}

***

### Các câu hỏi thường gặp