# Avnet Device API

**Canonical:** https://apis.io/apis/avnet/avnet-device-api/  
**Provider:** Avnet — https://apis.io/providers/avnet/  
**Base URL:** https://apigw.avnet.com  
**Documentation:** https://apiportal.avnet.com/

Avnet Device API is one of 36 APIs that [Avnet](https://apis.io/providers/avnet/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Device. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

Device Api List

## Operations (60 of 148)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v2.1/Device` | Add new device |
| GET | `/api/v2.1/Device` | Get Device List |
| PUT | `/api/v2.1/Device/{deviceGuid}` | Update a device |
| DELETE | `/api/v2.1/Device/{deviceGuid}` | Delete a device |
| PUT | `/api/v2.1/Device/{uniqueId}/acquire` | Acquire device broker info from cloud |
| PUT | `/api/v2.1/Device/{uniqueId}/release` | Release device from cloud |
| PUT | `/api/v2.1/Device/{deviceGuid}/status` | Update device status |
| GET | `/api/v2.1/Device/uniqueId/{uniqueId}` | Get all the details of single device |
| GET | `/api/v2.1/Device/lookup` | Get device lookup |
| GET | `/api/v2.1/template/{templateGuid}/device` | Get device list by templateGuid |
| GET | `/api/v2.1/entity/{entityGuid}/device` | Get device list by entityGuid |
| PUT | `/api/v2.1/entity/{entityGuid}/device` | Update device entity in bulk |
| GET | `/api/v2.1/company/{companyGuid}/device` | Get company wise device list |
| GET | `/api/v2.1/Device/{deviceGuid}/child-device` | Get list of child devices |
| POST | `/api/v2.1/import-batch` | Import devices in batch |
| GET | `/api/v2.1/import-batch` | Get device batch import list |
| POST | `/api/v2.1/import-validate-batch` | Validate Import devices in batch |
| GET | `/api/v2.1/Device/batch-bulk-delete/{batchGuid}/devices` | Get deleted device list based on batchguid |
| GET | `/api/v2.1/device-delete-historylist` | Get device delete historylist |
| GET | `/api/v2.1/import-batch/{importBatchGuid}` | Get list of all devices from a batch import request |
| POST | `/api/v2.1/import-batch/child-device` | Import child devices in batch |
| PUT | `/api/v2.1/Device/entity/{entityGuid}/change` | Update device entity in bulk with file or json |
| PUT | `/api/v2.1/Device/device-transfer/{entityGuid}` | Update device entity in bulk with file or json |
| PUT | `/api/v2.1/Device/{uniqueId}/twin` | Update device shadow |
| GET | `/api/v2.1/Device/{uniqueId}/twin` | Get device shadow list |
| GET | `/api/v2.1/Device/{uniqueId}/twinjson` | Get device shadow json |
| PUT | `/api/v2.1/Device/{deviceGuid}/properties` | Update device properties |
| DELETE | `/api/v2.1/Device/{deviceGuid}/property/{deviceInfoGuid}` | Delete a device property |
| GET | `/api/v2.1/Device/property` | Get device property list |
| POST | `/api/v2.1/Device/{deviceGuid}/grant` | Grant device permission |
| GET | `/api/v2.1/Device/{deviceGuid}/grant` | Get device permissions list |
| PUT | `/api/v2.1/Device/user-device-permission/{userDevicePermissionGuid}` | Update device permissions |
| DELETE | `/api/v2.1/Device/user-device-permission/{userDevicePermissionGuid}/revoke` | Revoke device permissions |
| POST | `/api/v2.1/Device/user/{userGuid}/grant` | Allotted devices to user |
| GET | `/api/v2.1/Device/user` | Get device allotted list |
| GET | `/api/v2.1/Device/user/{userGuid}` | Get user’s allotted devices |
| GET | `/api/v2.1/Device/{deviceGuid}/broker-info` | Get device broker info |
| PUT | `/api/v2.1/Device/{deviceGuid}/last-activity` | Update last activity date of device |
| GET | `/api/v2.1/Device/recent-activity` | Get recently acquired device list |
| GET | `/api/v2.1/Device/{uniqueId}/lifecycle` | Get device life cycle |
| GET | `/api/v2.1/Device/connection-status` | Get device connection status |
| GET | `/api/v2.1/Device/count` | Get device count |
| GET | `/api/v2.1/Device/counters` | Get device count statistics |
| GET | `/api/v2.1/Device/{uniqueId}/diagnostics/from/{fromDate}/to/{toDate}` | Get device diagnostics detail |
| POST | `/api/v2.1/Device/diagnostics` | Get device diagnostics detail |
| GET | `/api/v2.1/Device/statistic` | Get device count statistics |
| GET | `/api/v2.1/Device/DeviceDashboardCount` | Get device dashboard count |
| DELETE | `/api/v2.1/Device/property/{propertyGuid}/company/{companyGuid}` | Delete a device property |
| POST | `/api/v2.1/Device/unassociated` | Add new device |
| GET | `/api/v2.1/Device/unassociated` | Get Device List |
| PUT | `/api/v2.1/Device/unassociated/attach/bulk` | Replace api device unassociated attach bulk |
| DELETE | `/api/v2.1/Device/unassociated/{deviceGuid}` | Delete a unassociated device |
| GET | `/api/v2.1/Device/audit-log` | Get invalid device communications |
| GET | `/api/v2.1/Device/iothub-connection` | Refresh device connection |
| GET | `/api/v2.1/Device/assume-role` | Get api device assume role |
| GET | `/api/v2.1/Device/importTypes/lookup` | Get ImportType lookup |
| POST | `/api/v2.1/validate-external-device` | Validate External devices in batch |
| POST | `/api/v2.1/validate-batch` | Validate External devices in batch |
| GET | `/api/v2.1/external-device-batch-import-file/{importBatchGuid}` | Get external device import file content |
| GET | `/api/v2.1/external-device-validated/{importBatchGuid}/{isSuccess}` | Get external device import file content |

…and 88 more operations. They are listed in full on the page.

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/avnet/refs/heads/main/openapi/avnet-device-api-openapi.yml
- **Documentation** — https://docs.iotconnect.io/iotconnect/rest-api/master/?env=prod&pf=az
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/avnet/refs/heads/main/authentication/avnet-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/avnet/refs/heads/main/conventions/avnet-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/avnet/refs/heads/main/errors/avnet-problem-types.yml
- **Documentation** — https://docs.iotconnect.io/iotconnect/rest-api/auth/?env=prod&pf=az
- **Documentation** — https://docs.iotconnect.io/iotconnect/rest-api/user/?env=prod&pf=az
- **Documentation** — https://docs.iotconnect.io/iotconnect/rest-api/device/?env=prod&pf=az
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/avnet/refs/heads/main/data-model/avnet-data-model.yml
- **Documentation** — https://docs.iotconnect.io/iotconnect/rest-api/firmware/?env=prod&pf=az
- **Documentation** — https://docs.iotconnect.io/iotconnect/rest-api/event/?env=prod&pf=az
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/avnet/refs/heads/main/asyncapi/avnet-iotconnect-webhooks.yml
- **Documentation** — https://docs.iotconnect.io/iotconnect/rest-api/telemetry/?env=prod&pf=az
- **Documentation** — https://docs.iotconnect.io/iotconnect/rest-api/file/?env=prod&pf=az

## Other Avnet APIs (12)

- [Avnet API Portal (Procurement APIs)](https://apis.io/apis/avnet/avnet-api-portal-procurement-apis/)
- [Avnet ADU Group API](https://apis.io/apis/avnet/avnet-adugroup-api/)
- [Avnet Attribute API](https://apis.io/apis/avnet/avnet-attribute-api/)
- [Avnet Auth API](https://apis.io/apis/avnet/avnet-auth-api/)
- [Avnet Azure Sphere API](https://apis.io/apis/avnet/avnet-azuresphere-api/)
- [Avnet Certificate API](https://apis.io/apis/avnet/avnet-certificate-api/)
- [Avnet Cloud Template API](https://apis.io/apis/avnet/avnet-cloudtemplate-api/)
- [Avnet Command API](https://apis.io/apis/avnet/avnet-command-api/)
- [Avnet Deployment API](https://apis.io/apis/avnet/avnet-deployment-api/)
- [Avnet Device Operation API](https://apis.io/apis/avnet/avnet-deviceoperation-api/)
- [Avnet Device Update API](https://apis.io/apis/avnet/avnet-deviceupdate-api/)
- [Avnet Direct Method API](https://apis.io/apis/avnet/avnet-directmethod-api/)

## Tags

Device

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/avnet/avnet-device-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/avnet/.
