Favicon

You are here: Home > API Reference > Apple > Apple Dep Devices > Get list of admDepDevice

Get list of admDepDevice

Required Permission: mdm.apple.depDevice.list

Get list of admDepDevice

GET
/v1/organizations/:organizationId/mdm/apple/enterprise/dep/devices/
Copy to clipboard

Get list of admDepDevice

Required Permission: mdm.apple.depDevice.list

Get list of admDepDevice

Request

Add parameter in header authorization
Example: Authorization: Bearer <token>
organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$
page integer
optional
Sequential page index for navigating large datasets, enabling systematic access to specific record subsets within the total collection.
limit integer
optional
Maximum number of records returned per request to control data density, optimize interface performance, and manage payload size
sort string
optional
Ordering criteria using a field-to-direction mapping to organize results based on specific attributes like creation date, name, or status.
Match pattern: ^[\w.]*((:asc)|(:desc))?$
search string
optional
≤ 128 characters
serialNumber string
optional
≤ 500 characters
status string
optional
assignedpushedremovednotAssigned
profileName string
optional
≤ 128 characters
admEnrollmentTemplateId string
optional
Match pattern: ^[a-fA-F0-9]{24}$

Responses

200 Response application/json
status boolean optional
data object optional
items array [object] optional
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
organization string optional
Match pattern: ^[a-fA-F0-9]{24}$
admEnterprise string optional
Match pattern: ^[a-fA-F0-9]{24}$
serialNumber string optional
≤ 256 characters
assetTag string optional
≤ 256 characters
description string optional
≤ 256 characters
deviceModel string optional
≤ 256 characters
color string optional
≤ 256 characters
os string optional
iOS OSX tvOS
profile object optional
uuid string optional
≤ 256 characters
assignTime string optional
Format: date-time
pushTime string optional
Format: date-time
status string optional
assigned pushed removed
device object optional
assignedBy string optional
≤ 256 characters
assignedDate string optional
Format: date-time
family string optional
≤ 256 characters
op object optional
type string optional
added modified deleted
date string optional
Format: date-time
admDepProfileId string optional
Match pattern: ^[a-fA-F0-9]{24}$
admDepProfileInfo object optional
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
profileName string optional
≤ 256 characters
admEnrollmentTemplateId string optional
Match pattern: ^[a-fA-F0-9]{24}$
admEnrollmentTemplateInfo object optional
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
name string optional
≤ 256 characters
segmentId integer optional
≥ 0
config object optional
admPolicyId string optional
Match pattern: ^[a-fA-F0-9]{24}$
admPolicyAssignments array [object] optional
admPolicyId string optional
Match pattern: ^[a-fA-F0-9]{24}$
priority integer required
≥ 0 · ≤ 10000
admVppLocationId string optional
Match pattern: ^[a-fA-F0-9]{24}$
mdmUserId string optional
Match pattern: ^[a-fA-F0-9]{24}$
commands array [object] optional
displayNamePattern string optional
≤ 256 characters
setDeviceName boolean optional
tags array [string] optional
allowActivationLock boolean optional
setupAssistantEnable boolean optional
setupAssistantSkippable boolean optional
ssoInfo object optional
email string optional
≤ 256 characters · Format: email
firstName string optional
≤ 256 characters
lastName string optional
≤ 256 characters
userName string optional
≤ 256 characters
tags array [string] optional
skipPersonalInfo boolean optional
segmentId integer optional
≥ 0
version integer optional
≥ 0
updatedAt string optional
Format: date-time
createdAt string optional
Format: date-time
admDevice object optional
id string optional
Match pattern: ^[a-fA-F0-9]{24}$
enrolledDate string optional
Format: date-time
state string optional
PROVISIONING ACTIVE DELETED UNKNOWN EXPIRED PENDING
totalDocs integer optional
limit integer optional
hasPrevPage boolean optional
hasNextPage boolean optional
page integer optional
totalPages integer optional
prevPage integer optional
nextPage integer optional
lean boolean optional
{
    "status": true,
    "data": {
        "items": [
            {
                "id": "string",
                "organization": "string",
                "admEnterprise": "string",
                "serialNumber": "string",
                "assetTag": "string",
                "description": "string",
                "deviceModel": "string",
                "color": "string",
                "os": "iOS",
                "profile": {
                    "uuid": "string",
                    "assignTime": "2024-01-01T00: 00:00Z",
                    "pushTime": "2024-01-01T00: 00:00Z",
                    "status": ""
                },
                "device": {
                    "assignedBy": "string",
                    "assignedDate": "2024-01-01T00: 00:00Z",
                    "family": "string"
                },
                "op": {
                    "type": "added",
                    "date": "2024-01-01T00: 00:00Z"
                },
                "admDepProfileId": "string",
                "admDepProfileInfo": {
                    "id": "string",
                    "profileName": "string"
                },
                "admEnrollmentTemplateId": "string",
                "admEnrollmentTemplateInfo": {
                    "id": "string",
                    "name": "string",
                    "segmentId": 0
                },
                "config": {
                    "admPolicyId": "string",
                    "admPolicyAssignments": [
                        {
                            "admPolicyId": "string",
                            "priority": 0
                        }
                    ],
                    "admVppLocationId": "string",
                    "mdmUserId": "string",
                    "commands": [
                        {}
                    ],
                    "displayNamePattern": "string",
                    "setDeviceName": true,
                    "tags": [
                        "string"
                    ],
                    "allowActivationLock": true,
                    "setupAssistantEnable": true,
                    "setupAssistantSkippable": true,
                    "ssoInfo": {
                        "email": "[email protected]",
                        "firstName": "string",
                        "lastName": "string",
                        "userName": "string",
                        "tags": [
                            "string"
                        ]
                    },
                    "skipPersonalInfo": true,
                    "segmentId": 0
                },
                "version": 0,
                "updatedAt": "2024-01-01T00: 00:00Z",
                "createdAt": "2024-01-01T00: 00:00Z",
                "admDevice": {
                    "id": "string",
                    "enrolledDate": "2024-01-01T00: 00:00Z",
                    "state": "PROVISIONING"
                }
            }
        ],
        "totalDocs": 0,
        "limit": 0,
        "hasPrevPage": true,
        "hasNextPage": true,
        "page": 0,
        "totalPages": 0,
        "prevPage": 0,
        "nextPage": 0,
        "lean": true
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}