---
title: "Get all devices provisioned to a merchant"
method: GET
path: "/v3/merchants/{mId}/devices"
tags: ["MERCHANTS"]
---

# Get all devices provisioned to a merchant

`GET /v3/merchants/{mId}/devices`

Returns a list of all devices that are provisioned to the a merchant. This list can be viewed from the Setup App on the merchant's device or web dashboard (https://www.clover.com/setupapp/m/{mId}/devices).

## Path parameters

- `mId` string, required

## Query parameters

- `filter` string

## Headers

- `User-Agent` string, required

## Response `200`

- object
  - `id` string — Unique identifier
  - `name` string — Name of the device (if entered)
  - `model` string
  - `merchant` object
    - `id` string — Unique identifier.
  - `orderPrefix` string — A prefix that will be applied to order numbers. This is useful if the merchant and/or customer needs to track which device an order came from.
  - `terminalId` string — The merchant device's terminal Id. FD-IPG sets the merchant_device terminal Id for LATAM devices
  - `terminalPrefix` integer
  - `serial` string — The device's serial number.
  - `buildNumber` integer
  - `secureId` string
  - `buildType` 'ENG' | 'USER' | 'USERDEBUG'
  - `cpuId` string
  - `imei` string — The IMEI of the device
  - `imsi` string — The IMSI of the SIM in the device (if present)
  - `simIccid` string — The ICCID of the SIM in the device (if present)
  - `deviceCertificate` string
  - `pedCertificate` string
  - `deviceTypeName` string
  - `productName` string
  - `pinDisabled` boolean — Whether this device has PIN prompt disabled.
  - `offlinePayments` boolean
  - `offlinePaymentsAll` boolean
  - `offlinePaymentsLimit` integer
  - `offlinePaymentsPromptThreshold` integer
  - `offlinePaymentsTotalPaymentsLimit` integer
  - `offlinePaymentsLimitDefault` integer
  - `offlinePaymentsPromptThresholdDefault` integer
  - `offlinePaymentsTotalPaymentsLimitDefault` integer
  - `offlinePaymentsMaxLimit` integer
  - `offlinePaymentsMaxTotalPaymentsLimit` integer
  - `showOfflinePayments` boolean
  - `maxOfflineDays` integer
  - `allowStoreAndForward` boolean
  - `secureReports` object[]
    - `id` string — Unique identifier.
  - `bundleIndicator` string
  - `deviceType` object
    - `id` string — Unique identifier.

---

[API](https://skmtc.net/clover/apis/platform-api.md) · [All operations](https://skmtc.net/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clover/platform-api/revisions/08da265101a3/schema)