# claimDevice

Synchronous request to claim a single device for a specified customer.

> [!NOTE]
> **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` class doesn't support this API. Use [`claimDeviceAsync`](https://developers.google.com/zero-touch/reseller-library/reference/methods/claimdevicesasync) instead.

## Method signature

    public ClaimDeviceResponse claimDevice(ClaimDeviceRequest request) throws CommonException;

## ClaimDeviceRequest

| Property name | Value | Required | Description |
|---|---|---|---|
| `claim` | `DeviceClaim` object | Yes | The device claim to be processed. |

## DeviceClaim

| Property name | Value | Required | Description |
|---|---|---|---|
| `deviceIdentifier` | `object(`[`DeviceIdentifier`](https://developers.google.com/zero-touch/reseller-library/reference/methods/claimdevice#deviceidentifier)`)` | Yes | Device identifier. |
| `customer` | [`CompanyReference`](https://developers.google.com/zero-touch/reseller-library/reference/objects#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 |
|---|---|---|
| `deviceId` | `string` | The device ID, prefixed with 'samsung/' or 'google/'. |

## Error behavior

If an error occurs, the library throws a `CommonException` containing one of the
following error codes:

| Error code |
|---|
| `AUTHORIZATION_FAIL` |
| `DUPLICATE_DEVICES` |
| `INVALID_CUSTOMER_ID` |
| `INVALID_DEVICE_IMEI` |
| `INVALID_DEVICE_MEID` |
| `INVALID_DEVICE_SERIAL` |
| `INVALID_IDENTIFIER_SET` |
| `INVALID_MANUFACTURER` |
| `INVALID_MODEL` |
| `NOT_IMPLEMENTED` |