---
title: "POST /v1/partners/{+partnerId}/devices:claimAsync"
method: POST
path: "/v1/partners/{+partnerId}/devices:claimAsync"
tags: ["partners"]
---

# POST /v1/partners/{+partnerId}/devices:claimAsync

`POST /v1/partners/{+partnerId}/devices:claimAsync`

Claims a batch of devices for a customer asynchronously. Adds the devices to zero-touch enrollment. To learn more, read [Long‑running batch operations](/zero-touch/guides/how-it-works#operations).

## Path parameters

- `partnerId` string, required

## Request body

- ClaimDevicesRequest — Request to claim devices asynchronously in batch. Claiming a device adds the device to zero-touch enrollment and shows the device in the customer's view of the portal.
  - `claims` PartnerClaim[] — Required. A list of device claims.
    - `sectionType` 'SECTION_TYPE_UNSPECIFIED' | 'SECTION_TYPE_SIM_LOCK' | 'SECTION_TYPE_ZERO_TOUCH' — Required. The section type of the device's provisioning record.
    - `configurationId` string, int64 — Optional. The ID of the configuration applied to the device section.
    - `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).
      - `imei` string — The device’s IMEI number. Validated on input.
      - `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).
      - `chromeOsAttestedDeviceId` string — An identifier provided by OEMs, carried through the production and sales process. Only applicable to Chrome OS devices.
      - `meid` string — The device’s MEID number.
      - `imei2` string — The device’s second IMEI number.
      - `meid2` string — The device’s second MEID number.
      - `deviceType` 'DEVICE_TYPE_UNSPECIFIED' | 'DEVICE_TYPE_ANDROID' | 'DEVICE_TYPE_CHROME_OS' — The type of the device
      - `serialNumber` string — The manufacturer's serial number for the device. This value might not be unique across different device models.
      - `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).
    - `customerId` string, int64 — The ID of the customer for whom the device is being claimed.
    - `googleWorkspaceCustomerId` string — The Google Workspace customer ID.
    - `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.
    - `preProvisioningToken` string — Optional. Must and can only be set for Chrome OS devices.
    - `simlockProfileId` string, int64 — Optional. Must and can only be set when DeviceProvisioningSectionType is SECTION_TYPE_SIM_LOCK. The unique identifier of the SimLock profile.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/androiddeviceprovisioning.md) · [All operations](https://skmtc.dev/google/apis/androiddeviceprovisioning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/androiddeviceprovisioning/revisions/8032eb5c1260/schema)