List apps in enterprise

Alternative Available

GET "/v2/apps (tenant iOS and Windows apps only)" or GET "https://{foo}-api.esper.cloud/api/v1/enterprise/{enterprise_id}/application/"

Lists all applications uploaded to an enterprise's application library. Returns a paginated collection of application records, including metadata such as package name, developer, category, and active status, with filter options to narrow results by name, package, SDK version, upload status, and timestamps. Default page size is 20.

About List Enterprise Applications

Esper's application library is the enterprise-level repository where APK files are uploaded and managed before deployment to devices. Each application entry groups multiple uploaded versions under a single record identified by package name. Applications can be filtered by active state, hidden status, and whether they have at least one uploaded version ready for deployment.

Key Query Parameters

application_name — partial or exact name filter package_name — filter by Android package name (e.g. com.example.app) has_uploaded_version — when true, returns only apps with at least one APK version on record is_hidden — filters default Esper system apps; defaults to false is_active — filter for currently active applications created_on_gt / created_on_lt / updated_on_gt / updated_on_lt — timestamp range filters for audit or sync Workflows limit — results per page (default: 20)

Common Use Cases

Inventory the full set of applications available for deployment across an enterprise Locate a specific app by package name before retrieving its versions for installation Identify apps that have no uploaded versions and may need attention

Best Practices

No need to delete prior versions. Multiple, different versions of apps can exist simultaneously. Applications must be removed from a blueprint before the blueprint can be deleted.

Workflow

Call this endpoint with relevant filters (name, package, active state) to find the target application Note the id field from the matching result — this is the application_id UUID needed for version lookups and installs Proceed to GET .../application/{application_id}/version/ to retrieve available versions