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

  1. GET this endpoint to review existing DEP profiles
  2. Create a new profile via POST if none of the existing ones fit
  3. Assign the desired profile to devices through Apple Business Manager / Esper's DEP enrollment flow
get/tenant/v0/depprofiles/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/tenant/v0/depprofiles/
  • Auth
    HTTP bearer

Response

DEP profile information for the Tenant

codeinteger
messagestring

Changes

No recorded changes to this operation across all 6 revisions of this API.