[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis API allows a synchronous request to claim a single device for a specific customer, utilizing the \u003ccode\u003eclaimDevice\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eclaimDevice\u003c/code\u003e method requires a \u003ccode\u003eClaimDeviceRequest\u003c/code\u003e object, which must include a \u003ccode\u003eDeviceClaim\u003c/code\u003e object containing the device identifier and customer details.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eDeviceClaim\u003c/code\u003e object necessitates a \u003ccode\u003eDeviceIdentifier\u003c/code\u003e and a \u003ccode\u003eCompanyReference\u003c/code\u003e object, optionally accepting an order number and vendor-specific parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eclaimDevice\u003c/code\u003e method returns a \u003ccode\u003eClaimDeviceResponse\u003c/code\u003e containing the device ID, prefixed with either 'samsung/' or 'google/'.\u003c/p\u003e\n"],["\u003cp\u003eThe API can throw a \u003ccode\u003eCommonException\u003c/code\u003e with various error codes, including \u003ccode\u003eAUTHORIZATION_FAIL\u003c/code\u003e, \u003ccode\u003eDUPLICATE_DEVICES\u003c/code\u003e, and several \u003ccode\u003eINVALID_*\u003c/code\u003e errors, indicating potential issues with the request.\u003c/p\u003e\n"]]],["This describes the `claimDevice` method, which synchronously claims a single device for a customer. It requires a `DeviceClaim` object containing the `deviceIdentifier` and `customer` details. Optional fields include `orderNumber` and `vendorParams`. The method returns a `ClaimDeviceResponse` containing the `deviceId`. Errors are handled by a `CommonException` with codes like `AUTHORIZATION_FAIL`, `INVALID_CUSTOMER_ID`, and `DUPLICATE_DEVICES`. This API is not supported by the `ResellerService` class.\n"],null,["# claimDevice\n\nSynchronous request to claim a single device for a specified customer.\n| **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` class doesn't support this API. Use [`claimDeviceAsync`](/zero-touch/reseller-library/reference/methods/claimdevicesasync) instead.\n\nMethod signature\n----------------\n\n public ClaimDeviceResponse claimDevice(ClaimDeviceRequest request) throws CommonException;\n\nClaimDeviceRequest\n------------------\n\n| Property name | Value | Required | Description |\n|---------------|----------------------|----------|-----------------------------------|\n| `claim` | `DeviceClaim` object | Yes | The device claim to be processed. |\n\nDeviceClaim\n-----------\n\n| Property name | Value | Required | Description |\n|--------------------|----------------------------------------------------------------------------------------------|----------|--------------------------------------------------------------------|\n| `deviceIdentifier` | `object(`[`DeviceIdentifier`](#deviceidentifier)`)` | Yes | Device identifier. |\n| `customer` | [`CompanyReference`](/zero-touch/reseller-library/reference/objects#companyreference) object | Yes | Company reference for the customer that the device is assigned to. |\n| `orderNumber` | `string` | No | Order number. |\n| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. |\n\nClaimDeviceResponse\n-------------------\n\n| Property name | Value | Description |\n|---------------|----------|-------------------------------------------------------|\n| `deviceId` | `string` | The device ID, prefixed with 'samsung/' or 'google/'. |\n\nError behavior\n--------------\n\nIf an error occurs, the library throws a `CommonException` containing one of the\nfollowing error codes:\n\n| Error code |\n|--------------------------|\n| `AUTHORIZATION_FAIL` |\n| `DUPLICATE_DEVICES` |\n| `INVALID_CUSTOMER_ID` |\n| `INVALID_DEVICE_IMEI` |\n| `INVALID_DEVICE_MEID` |\n| `INVALID_DEVICE_SERIAL` |\n| `INVALID_IDENTIFIER_SET` |\n| `INVALID_MANUFACTURER` |\n| `INVALID_MODEL` |\n| `NOT_IMPLEMENTED` |"]]
