Join BoxWorks 2024 to discover what's possible with content and AI!
Register now!Get device pin
Retrieves information about an individual device pin.
Request
bearer [ACCESS_TOKEN]
application/json
Path Parameters
stringin pathrequired
2324234The ID of the device pin
Response
application/jsonDevice pinner
Returns information about a single device pin.
application/jsonClient error
An unexpected client error.
Request Example
cURL
curl -i -X GET "https://api.box.com/2.0/device_pinners/2324234" \
-H "authorization: Bearer <ACCESS_TOKEN>"Python Gen
client.device_pinners.get_device_pinner_by_id(device_pinner_id).NET Gen
await client.DevicePinners.GetDevicePinnerByIdAsync(devicePinnerId: devicePinnerId);Java
BoxDevicePin devicePin = new BoxDevicePin(api, id);
BoxDevicePin.Info devicePinInfo = devicePin.getInfo();Python
device_pin_id = '1111'
device_pin = client.device_pinner(device_pin_id).get()
print(f'{pin.product_name} device for {pin.owned_by.name} is pinned').NET
BoxDevicePin pin = await client.DevicePinManager.GetDevicePin(id: "11111");Node
client.devicePins.get('11111')
.then(pin => {
/* pin -> {
type: 'device_pinner',
id: '11111',
owned_by:
{
type: 'user',
id: '22222',
name: 'Example User',
login: 'user@example.com'
},
product_name: 'iPad'
}
*/
});iOS
client.devicePins.get(devicePinId: "11111", fields: ["product_name"]) { (result: Result<DevicePin, BoxSDKError>) in
guard case let .success(devicePin) = result else {
print("Error retrieving device pin information")
return
}
print("Device Pin for \(devicePin.productName) was created at \(devicePin.createdAt)")
}Response Example
{
"id": "11446498",
"type": "device_pinner",
"owned_by": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
},
"product_name": "iPad"
}