tenant_DEP Profile
Get all DEP profiles for the tenant
Retrieves all DEP profiles configured for the tenant.
Returns the tenant's Device Enrollment Program (DEP) profiles, which define the enrollment/setup experience for iOS devices enrolled via Apple Business Manager.
About DEP Profiles A DEP profile controls what a user sees and can configure during initial setup of a DEP-enrolled iOS device — including which setup screens are shown and whether setup advances automatically. DEP profiles require a working DEP token connection to Apple Business Manager.
Common Use Cases
- Reviewing existing DEP profiles before assigning one to a batch of newly-ordered devices
- Auditing the enrollment experience configured for different device cohorts
- Finding a DEP profile to reuse for a new zero-touch iOS deployment
Best Practices
- Confirm the tenant's DEP token is valid before relying on DEP profiles for enrollment
- Review show_setup_items and auto_advance_setup settings against the intended end-user experience
- Create purpose-specific profiles (e.g., kiosk vs. BYOD-style setup) rather than reusing one profile for very different use cases
Workflow
- GET this endpoint to review existing DEP profiles
- Create a new profile via POST if none of the existing ones fit
- Assign the desired profile to devices through Apple Business Manager / Esper's DEP enrollment flow
get/tenant/v0/depprofiles/
Request
- Base URLhttps://develop-api.esper.cloud/api
- URLhttps://develop-api.esper.cloud/api/tenant/v0/depprofiles/
- AuthHTTP bearer
Response
DEP profile information for the Tenant
Changes
No recorded changes to this operation across all 6 revisions of this API.