Getting device information

Send a GET request to /device-details/v1/device-info endpoint of the device details API to obtain device details for all Toast POS app devices and printers for a location. For more information about the returned values, see About the Devices object.

The following curl command sends a GET request to the endpoint. 

curl -i -x GET \ 'https://[toast-api-hostname]/device-details/v1/device-info' \ 1
 -H 'Toast-Restaurant-External-ID: 95a96d7b-dbf5-46d3-98c5-c65c8ad18021' \ 2
 -H 'Authorization: Bearer [token]' 3

1

Send a GET request to the /device-details/v1/device-info endpoint of the device details API.

2

Specify the GUID of the location that you want to get device details from. This must be the GUID of a single location. It cannot be the GUID of a location group.

3

Include an authentication token. For more information, see Authentication and restaurant access.

The following example shows the JSON response data for the GET request. 

[
    {
        "serialNumber": "AB12345C67890",
        "deviceType": "POS",1
        "deviceModel": "TT200",
        "deviceModelName": "14\" Toast Flex",
        "posDeviceInfo": {2
            "posType": "TERMINAL",3
            "deviceName": "POS Dining Room",
            "deviceId": "a12bc3d456ef6789",
            "lastSyncedAt": "2026-06-21T15:14:24.22Z",
            "primaryMode": "Payment Terminal",
            "orderAutofireEnabled": false,
            "pciCompliant": true,
            "pciNonComplianceReason": null,
            "ipAddress": "192.0.2.0",
            "ipType": "UNKNOWN",
            "macAddress": "12:a3:b4:c5:d6:e7",
            "networkName": null,
            "networkConnectionType": "RJ45",
            "deviceUptimeMillis": 2675233,
            "posAppVersion": "2.110.1",
            "firmwareVersion": "2.0.52",
            "androidOsVersion": "9.0",
            "androidOsSdkLevel": 28,
            "securityPatchVersion": "2026-01-01"
        },
        "printerDeviceInfo": null4
    },
    {
        "serialNumber": "D1EF2G3456",
        "deviceType": "POS",5
        "deviceModel": "TG200",
        "deviceModelName": "Toast Go 2",
        "posDeviceInfo": {6
            "posType": "HANDHELD",7
            "deviceName": "Bar/Patio",
            "deviceId": "a1b2c3d4-e5f6-7890-ghij-kl1234567890",
            "lastSyncedAt": "2026-06-17T09:13:48.709Z",
            "primaryMode": "Quick Order",
            "orderAutofireEnabled": false,
            "pciCompliant": true,
            "pciNonComplianceReason": null,
            "ipAddress": "10.0.0.0",
            "ipType": "DHCP",
            "macAddress": "F8:A9:B0:12:3C:45",
            "networkName": "Restaurant-POS",
            "networkConnectionType": "WIFI",
            "deviceUptimeMillis": 172800000,
            "posAppVersion": "2.110.0",
            "firmwareVersion": "2.1.0",
            "androidOsVersion": "13.0",
            "androidOsSdkLevel": 33,
            "securityPatchVersion": "2026-01-01"
        },
        "printerDeviceInfo": null8
    },
    {
        "serialNumber": "HI7J8K9012",
        "deviceType": "PRINTER",9
        "deviceModel": "SNBC_S80",
        "deviceModelName": "TP200 - Toast Receipt Printer",
        "posDeviceInfo": null,10
        "printerDeviceInfo": {11
            "deviceName": "Receipt Printer 1",
            "lastSyncedAt": "2026-06-05T18:58:24.898Z",
            "firmwareVersion": "FV1.234",
            "ipAddress": "10.0.0.1",
            "ipType": "STATIC",
            "macAddress": "01234567890A",
            "gatewayAddress": "10.0.0.2",
            "netmaskAddress": "255.255.255.0",
            "printerPort": "9012"
        }
    }
]

1

The deviceType for the Device object is POS.

2

The PosDeviceInfo object is populated because the deviceType is POS.

3

The posType value is TERMINAL.

4

The PrinterDeviceInfo object is null because the deviceType is not PRINTER.

5

The deviceType for the Device object is POS.

6

The PosDeviceInfo object is populated because the deviceType is POS.

7

The posType value is HANDHELD.

8

The PrinterDeviceInfo object is null because the deviceType is not PRINTER.

9

The deviceType for the Device object is PRINTER.

10

The PosDeviceInfo object is null because the deviceType is not POS.

11

The PrinterDeviceInfo object is populated because the deviceType is PRINTER.