> For the complete documentation index, see [llms.txt](https://docs.payengine.co/payengine-api-v2.5/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payengine.co/payengine-api-v2.5/device-management/list-all-devices.md).

# List all devices

## Get all devices associated with the merchant account

<mark style="color:blue;">`GET`</mark> `https://<Platform-host>/api/merchant/:merchantId/devices`

#### Path Parameters

| Name                                         | Type   | Description                  |
| -------------------------------------------- | ------ | ---------------------------- |
| merchantId<mark style="color:red;">\*</mark> | string | Platform unique merchant ID |

{% tabs %}
{% tab title="200: OK " %}
{% tabs %}
{% tab title="Field Definitions" %}

<table><thead><tr><th width="256.6497763813563">Field Name</th><th width="150">Types</th><th>Description</th></tr></thead><tbody><tr><td>data.devices</td><td>array</td><td>Available devices</td></tr><tr><td>data.devices[i].device_id</td><td>string</td><td>Unique device ID</td></tr><tr><td>data.devices[i].make</td><td>string</td><td>Device make</td></tr><tr><td>data.devices[i].model</td><td>string</td><td>Device model</td></tr><tr><td>data.devices[i].last_transaction_date</td><td>timestamp</td><td>Last transaction executed on this device</td></tr><tr><td>data.devices[i].date_registered</td><td>timestamp</td><td>Date device was registered</td></tr><tr><td>data.devices[i].date_deregistered</td><td>timestamp</td><td>Date device was deregistered or null if not deregistered</td></tr><tr><td>data.devices[i].connection_status</td><td>string</td><td>disconnected | connected</td></tr><tr><td>data.devices[i].last_connected_date</td><td>timestamp</td><td>Last connected date</td></tr><tr><td>data.devices[i].last_disconnected_date</td><td>timestamp</td><td>Last disconnected date</td></tr><tr><td>data.devices[i].device_nickname</td><td>string</td><td>Device nickname</td></tr><tr><td>data.devices[i].registration_status</td><td>string</td><td>deregistered | registered</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample Response" %}

```javascript
{
    "data": {
        "devices": [
            {
                "device_id": "e68f0d4b-6a64-4426-a7b7-062be8e4d32e",
                "make": "ingenico",
                "model": "LK2500",
                "last_transaction_date": "2022-03-14 18:44:37",
                "date_registered": "2022-03-11 20:24:27",
                "date_deregistered": null,
                "serial_number": "3091200920860040",
                "connection_status": "connected",
                "last_connected_date": "2022-03-14 16:06:26",
                "last_disconnected_date": null,
                "device_nickname": "Link 2500 SN60040",
                "registration_status": "registered"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Sample Response" %}

```javascript
{
    "data": {
        "devices": [
            {
                "device_id": "e68f0d4b-6a64-4426-a7b7-062be8e4d32e",
                "make": "ingenico",
                "model": "LK2500",
                "last_transaction_date": "2022-03-14 18:44:37",
                "date_registered": "2022-03-11 20:24:27",
                "date_deregistered": null,
                "serial_number": "3091200920860040",
                "connection_status": "connected",
                "last_connected_date": "2022-03-14 16:06:26",
                "last_disconnected_date": null,
                "device_nickname": "Link 2500 SN60040",
                "registration_status": "registered"
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}