---
title: "List apps in enterprise"
method: GET
path: "/enterprise/{enterprise_id}/application/"
tags: ["esper_cloud_api_Application"]
---

# List apps in enterprise

`GET /enterprise/{enterprise_id}/application/`

**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 **Workflow**s
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

## Path parameters

- `enterprise_id` string, required

## Query parameters

- `application_name` string
- `package_name` string
- `package_name_exact` string
- `has_uploaded_version` boolean
- `category` string
- `supported_sdk` integer
- `is_active` boolean
- `is_hidden` boolean
- `created_on_gt` string, datetime
- `created_on_lt` string, datetime
- `updated_on_gt` string, datetime
- `updated_on_lt` string, datetime
- `limit` integer
- `offset` integer

## Response `200`

successful operation

- object
  - `count` integer, required
  - `next` string, url, nullable
  - `previous` string, url, nullable
  - `results` EsperCloudApiApplication[], required
    - `id` string, uuid
    - `versions` EsperCloudApiApplicationVersion[]
      - `id` string, uuid
      - `version_code` string
      - `build_number` string, nullable
      - `hash_string` string
      - `min_sdk_version` string, nullable
      - `target_sdk_version` string, nullable
      - `download_url` string, url
      - `icon_url` string, url
      - `release_name` string
      - `release_comments` string
    - `application_name` string, required
    - `package_name` string, required
    - `developer` string, nullable
    - `category` string, nullable
    - `content_rating` string, decimal
    - `compatibility` string, nullable
    - `created_on` string, date-time
    - `updated_on` string, date-time
    - `is_active` boolean
    - `is_hidden` boolean
    - `enterprise` string, url, required

## Other responses

- `401` — Authorization information is missing or invalid.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/versions/e1f64cbb488e/schema)