# claimDevicesAsync

Asynchronous request to claim up to 100,000 devices for one or more customers.

> [!NOTE]
> **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` only supports claiming devices for one customer per request. If devices for multiple customers are put into a single request, the operation will fail and return `INTERNAL_SERVER_ERROR`.

Asynchronous API methods return a result before the processing is complete. They
also help your app (or tool) remain responsive for your users while they wait
for a long-running operation to complete. Your app should call
[`getOperation`](https://developers.google.com/zero-touch/reseller-library/reference/methods/getoperation)
to check the status of the operation periodically.

## Method signature

    public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

## ClaimDeviceRequest

| Property name | Value | Required | Description |
|---|---|---|---|
| `claims` | List of `object(DeviceClaim)` | Yes | List of device claims to claim for the customer. |

## DeviceClaim

| Property name | Value | Required | Description |
|---|---|---|---|
| `deviceIdentifier` | `object(`[`DeviceIdentifier`](https://developers.google.com/zero-touch/reseller-library/reference/methods/claimdevicesasync#deviceidentifier)`)` | Yes | Device identifier. |
| `customer` | `CompanyReference` object | Yes | Company reference for the customer that the device is assigned to. |
| `orderNumber` | `string` | No | Order number. |
| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. |

## ClaimDeviceResponse

| Property name | Value | Description |
|---|---|---|
| `operations` | List of `Operation` objects | One or more `ClaimDevices` `Operation` instances. |

## Error behavior

If an error occurs, the `Operation` object returns one of the following error
codes:

| Error code |
|---|
| `DEVICE_UPLOAD_COUNT_EXCEEDED` |
| `DUPLICATE_DEVICES` |
| `INTERNAL_SERVER_ERROR` |
| `INVALID_CUSTOMER_ID` |
| `INVALID_DEVICE_IMEI` |
| `INVALID_DEVICE_MEID` |
| `INVALID_DEVICE_SERIAL` |
| `INVALID_IDENTIFIER_SET` |
| `INVALID_MANUFACTURER` |
| `INVALID_MODEL` |