---
title: "POST /v1/partners/{partnersId}/devices:findByIdentifier"
method: POST
path: "/v1/partners/{partnersId}/devices:findByIdentifier"
tags: ["partners"]
---

# POST /v1/partners/{partnersId}/devices:findByIdentifier

`POST /v1/partners/{partnersId}/devices:findByIdentifier`

## Request

- Base URL: `https://androiddeviceprovisioning.googleapis.com`
- URL: `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnersId}/devices:findByIdentifier`
- Auth: none declared

Finds devices by hardware identifiers, such as IMEI.

## Path parameters

- `partnersId` string, required

## Request body

- FindDevicesByDeviceIdentifierRequest: Request to find devices.
  - `deviceIdentifier` DeviceIdentifier: Encapsulates hardware and product IDs to identify a manufactured device. To understand requirements on identifier sets, read [Identifiers](https://developers.google.com/zero-touch/guides/identifiers).
    - `chromeOsAttestedDeviceId` string: An identifier provided by OEMs, carried through the production and sales process. Only applicable to Chrome OS devices.
    - `deviceType` 'DEVICE_TYPE_UNSPECIFIED' | 'DEVICE_TYPE_ANDROID' | 'DEVICE_TYPE_CHROME_OS': The type of the device
    - `imei` string: The device’s IMEI number. Validated on input.
    - `imei2` string: The device’s second IMEI number.
    - `manufacturer` string: The device manufacturer’s name. Matches the device's built-in value returned from `android.os.Build.MANUFACTURER`. Allowed values are listed in [Android manufacturers](/zero-touch/resources/manufacturer-names#manufacturers-names).
    - `meid` string: The device’s MEID number.
    - `meid2` string: The device’s second MEID number.
    - `model` string: The device model's name. Allowed values are listed in [Android models](/zero-touch/resources/manufacturer-names#model-names) and [Chrome OS models](https://support.google.com/chrome/a/answer/10130175#identify_compatible).
    - `serialNumber` string: The manufacturer's serial number for the device. This value might not be unique across different device models.
  - `limit` string, int64: Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive.
  - `pageToken` string: A token specifying which result page to return.

## Response `200`

Successful response

- FindDevicesByDeviceIdentifierResponse: Response containing found devices.
  - `devices` Device[]: Found devices.
    - `claims` DeviceClaim[]: Output only. The provisioning claims for a device. Devices claimed for zero-touch enrollment have a claim with the type `SECTION_TYPE_ZERO_TOUCH`. Call `partners.devices.unclaim` or `partners.devices.unclaimAsync` to remove the device from zero-touch enrollment.
      - `additionalService` 'ADDITIONAL_SERVICE_UNSPECIFIED' | 'DEVICE_PROTECTION': The Additional service registered for the device.
      - `googleWorkspaceCustomerId` string: The ID of the Google Workspace account that owns the Chrome OS device.
      - `ownerCompanyId` string, int64: The ID of the Customer that purchased the device.
      - `resellerId` string, int64: The ID of the reseller that claimed the device.
      - `sectionType` 'SECTION_TYPE_UNSPECIFIED' | 'SECTION_TYPE_SIM_LOCK' | 'SECTION_TYPE_ZERO_TOUCH': Output only. The type of claim made on the device.
      - `vacationModeExpireTime` string, google-datetime: The timestamp when the device will exit ‘vacation mode’. This value is present iff the device is in 'vacation mode'.
      - `vacationModeStartTime` string, google-datetime: The timestamp when the device was put into ‘vacation mode’. This value is present iff the device is in 'vacation mode'.
    - `configuration` string: Not available to resellers.
    - `deviceId` string, int64: Output only. The ID of the device. Assigned by the server.
    - `deviceIdentifier` DeviceIdentifier: Encapsulates hardware and product IDs to identify a manufactured device. To understand requirements on identifier sets, read [Identifiers](https://developers.google.com/zero-touch/guides/identifiers).
      - `chromeOsAttestedDeviceId` string: An identifier provided by OEMs, carried through the production and sales process. Only applicable to Chrome OS devices.
      - `deviceType` 'DEVICE_TYPE_UNSPECIFIED' | 'DEVICE_TYPE_ANDROID' | 'DEVICE_TYPE_CHROME_OS': The type of the device
      - `imei` string: The device’s IMEI number. Validated on input.
      - `imei2` string: The device’s second IMEI number.
      - `manufacturer` string: The device manufacturer’s name. Matches the device's built-in value returned from `android.os.Build.MANUFACTURER`. Allowed values are listed in [Android manufacturers](/zero-touch/resources/manufacturer-names#manufacturers-names).
      - `meid` string: The device’s MEID number.
      - `meid2` string: The device’s second MEID number.
      - `model` string: The device model's name. Allowed values are listed in [Android models](/zero-touch/resources/manufacturer-names#model-names) and [Chrome OS models](https://support.google.com/chrome/a/answer/10130175#identify_compatible).
      - `serialNumber` string: The manufacturer's serial number for the device. This value might not be unique across different device models.
    - `deviceMetadata` DeviceMetadata: Metadata entries that can be attached to a `Device`. To learn more, read [Device metadata](https://developers.google.com/zero-touch/guides/metadata).
      - `entries` object: Metadata entries recorded as key-value pairs.
    - `name` string: Output only. The API resource name in the format `partners/[PARTNER_ID]/devices/[DEVICE_ID]`. Assigned by the server.
  - `nextPageToken` string: A token used to access the next page of results. Omitted if no further results are available.
  - `totalSize` integer: The total count of items in the list irrespective of pagination.

---

[API](https://skmtc.dev/google/apis/androiddeviceprovisioning.md) - [All operations](https://skmtc.dev/google/apis/androiddeviceprovisioning/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/androiddeviceprovisioning/revisions/87b1e2664607?raw)