Get provisioning profiles for a tenant
⚠️ Apple devices only.
Retrieve a paginated list of all iOS provisioning profiles registered for the tenant, including a signed download URL for each profile file. Returns profile metadata extracted from uploaded .mobileprovision files — App ID, team identifier, profile type, and expiration date — along with a signed download_url for retrieving the raw file. Results default to 10 per page and can be filtered by app_identifier, profile_type, team_id, or searched by name and identifier.
About List Provisioning Profiles
Provisioning profiles in Esper are uploaded per tenant and then attached to blueprints to authorize Enterprise iOS apps on managed devices. This endpoint provides the full tenant inventory of profiles, useful for auditing coverage, identifying profiles nearing expiration, and confirming which App IDs are registered. Each record represents a profile keyed by App ID; individual uploads of the same App ID create versioned records accessible via the versions sub-resource.
Key Fields / Query Parameters
limit — Max results per page; defaults to 10
offset — Number of records to skip for pagination; defaults to 0
app_identifier — Filter by bundle ID (e.g., com.example.app)
profile_type — Filter by development, ad-hoc, app-store, or enterprise
team_id — Filter by Apple Developer Team identifier
search — Search within profile names and identifiers
download_url (response) — Signed S3 URL for downloading the .mobileprovision file
Common Use Cases
Auditing which Enterprise app IDs have registered provisioning profiles in the tenant Identifying profiles approaching expiration before device-side installation failures occur Retrieving profile IDs needed to fetch version history or attach profiles to blueprints via the API
Best Practices
Filter by profile_type=enterprise to focus on profiles relevant to Enterprise app distribution
Use app_identifier filtering when managing profiles for a specific app across multiple versions
Paginate with limit and offset for tenants with large profile inventories; next and prev URLs are included in the response
Query parameters
Maximum number of provisioning profiles to return
Number of provisioning profiles to skip
Filter by bundle identifier of the associated app
Filter by profile type
Filter by Apple Developer Team identifier
Search in provisioning profile names and identifiers
Response
Success
Example response
{
"content": {
"results": [
{
"download_url": "https://s3.amazonaws.com/bucket/provisioning-profiles/profile.mobileprovision?signature=abc123"
}
]
}
}