Skip to content

Get all DEP profiles for the tenant
Stable

Request

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
Security
tenant_apiKey
cURL
curl -i -X GET \
  https://develop-api.esper.io/_mock/openapi/tenant/v0/depprofiles/ \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

DEP profile information for the Tenant

Bodyapplication/json
codeinteger
messagestring
contentobject
Response
{
  "code": 0,
  "message": "string",
  "content": {
    "count": 0,
    "previous": "string",
    "next": "string",
    "results": [ … ]
  }
}