API referenceDevices
List devices
List the devices that the device management connectors of the workspace report, with the owner, the Corma desktop agent of the owner and the last contact. A device that two connectors report shows once for each. Search on the name, the serial number, the UDID and the external id.
GET
/devicescurl -X GET "https://api.corma.io/v1/devices" \
-H "x-corma-api-key: $CORMA_OPEN_API_KEY"Authorization
x-corma-api-keystringheaderrequiredColon-separated API key ID and secret:
API_KEY_ID:API_KEY_SECRET
Parameters
takeintegerqueryDefault:50skipintegerqueryDefault:0filtersobjectquerysortobjectqueryThe field to sort on, and the direction. Rows with the same value are sorted by id.
Default:{"field":"name","direction":"asc"}searchstringqueryA text to find in the searchable columns of the resource.
%and_match literally.x-corma-workspace-idsstringheaderOptional comma-separated workspace ids, at most 100. Absent, the route serves the workspace of the credential. An API key can only name its own workspace. A bearer token can name the workspaces where its person is an admin member.
Response
application/json200
OK
paginationPaginationResponseMetarequireditemsobject[]required
{
"pagination": {
"take": 0,
"skip": 0,
"total": 0
},
"items": [
{
"id": -9007199254740991,
"workspace": {
"id": -9007199254740991,
"name": "string",
"logoUrl": "https://example.com"
},
"name": "string",
"externalId": "string",
"serialNumber": "string",
"udid": "string",
"os": "windows",
"osVersion": "string",
"source": {
"connectionId": -9007199254740991,
"kind": "google",
"method": "api",
"name": "string",
"connectionName": "string"
},
"owner": {
"id": "string",
"fullName": "string",
"email": "string"
},
"ownerAssignedManually": true,
"osAgentStatus": "connected",
"installedAppsCount": -9007199254740991,
"lastContactAt": "2026-01-15T09:30:00Z"
}
]
}