---
title: "Get Customer Device Infos (getCustomerDeviceInfos)"
method: GET
path: "/api/customer/{customerId}/deviceInfos"
tags: ["device-controller"]
---

# Get Customer Device Infos (getCustomerDeviceInfos)

`GET /api/customer/{customerId}/deviceInfos`

Returns a page of devices info objects assigned to customer. You can specify parameters to filter the results. The result is wrapped with PageData object that allows you to iterate over result set using pagination. See response schema for more details. Device Info is an extension of the default Device object that contains information about the assigned customer name and device profile name. 

Available for users with 'TENANT_ADMIN' or 'CUSTOMER_USER' authority.

## Path parameters

- `customerId` string, required

## Query parameters

- `pageSize` integer, required
- `page` integer, required
- `type` string
- `deviceProfileId` string
- `active` boolean
- `textSearch` string
- `sortProperty` 'createdTime' | 'name' | 'deviceProfileName' | 'label' | 'customerTitle'
- `sortOrder` 'ASC' | 'DESC'

## Response `200`

OK

- PageDataDeviceInfo
  - `data` DeviceInfo[] — Array of the entities
    - `id` DeviceId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'DEVICE', required — string
    - `createdTime` integer — Timestamp of the device creation, in milliseconds
    - `tenantId` TenantId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'TENANT', required — string
    - `customerId` CustomerId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'CUSTOMER', required — string
    - `name` string, required — Unique Device Name in scope of Tenant
    - `type` string — Device Profile Name
    - `label` string — Label that may be used in widgets
    - `deviceProfileId` DeviceProfileId, required
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'DEVICE_PROFILE', required — string
    - `firmwareId` OtaPackageId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'OTA_PACKAGE', required — string
    - `softwareId` OtaPackageId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'OTA_PACKAGE', required — string
    - `version` integer
    - `customerTitle` string — Title of the Customer that owns the device.
    - `customerIsPublic` boolean — Indicates special 'Public' Customer that is auto-generated to use the devices on public dashboards.
    - `deviceProfileName` string — Name of the corresponding Device Profile.
    - `active` boolean — Device active flag.
    - `additionalInfo` unknown
    - `deviceData` DeviceData
      - `configuration` DefaultDeviceConfiguration
        - `type` string, required
      - `transportConfiguration` union — Device transport configuration used to connect the device
        - CoapDeviceTransportConfiguration
          - `type` string, required
          - `powerMode` 'PSM' | 'DRX' | 'E_DRX'
          - `psmActivityTimer` integer
          - `edrxCycle` integer
          - `pagingTransmissionWindow` integer
        - DefaultDeviceTransportConfiguration
          - `type` string, required
        - Lwm2mDeviceTransportConfiguration
          - `type` string, required
          - `powerMode` 'PSM' | 'DRX' | 'E_DRX'
          - `psmActivityTimer` integer
          - `edrxCycle` integer
          - `pagingTransmissionWindow` integer
        - MqttDeviceTransportConfiguration
          - `type` string, required
        - SnmpDeviceTransportConfiguration
          - `type` string, required
          - `host` string
          - `port` integer
          - `protocolVersion` 'V1' | 'V2C' | 'V3'
          - `community` string
          - `username` string
          - `securityName` string
          - `contextName` string
          - `authenticationProtocol` 'SHA_1' | 'SHA_224' | 'SHA_256' | 'SHA_384' | 'SHA_512' | 'MD5'
          - `authenticationPassphrase` string
          - `privacyProtocol` 'DES' | 'AES_128' | 'AES_192' | 'AES_256'
          - `privacyPassphrase` string
          - `engineId` string
  - `totalPages` integer — Total number of available pages. Calculated based on the 'pageSize' request parameter and total number of entities that match search criteria
  - `totalElements` integer — Total number of elements in all available pages
  - `hasNext` boolean — 'false' value indicates the end of the result set

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)