---
title: "Get tenant apps for a tenant"
method: GET
path: "/v2/tenant-apps"
tags: ["apps_management_Tenant Apps"]
---

# Get tenant apps for a tenant

`GET /v2/tenant-apps`

Retrieves a paginated list of all tenant-uploaded apps for iOS and Windows devices.

Returns each app's TenantAppResponse record, filterable by platform, package name, and app name.

**About Get Tenant Apps**

⚠️ iOS and Windows only. Tenant Apps are enterprise apps uploaded directly to Esper for distribution to iOS or Windows devices. This is the tenant-wide catalog view, separate from Tenant Esper Apps (Esper-provided apps) and from Android enterprise apps, which live in the older Application V1 API.

**Key Fields / Query Parameters**

platform — filters by APPLE or WINDOWS

package_name — filters by exact package name

app_name — filters by app name

**Common Use Cases**

Browsing the full catalog of uploaded iOS and Windows apps before assigning one to a blueprint

Finding an app's id to look up its available versions

**Best Practices**

Filter by platform when working with a single-OS fleet to avoid paging through apps for the other platform

Use package_name to find a specific app quickly rather than searching by app_name alone, since app_name is not guaranteed to be unique

**Workflow**

Call this endpoint with the desired filters

Identify the appId for the app you need

Call GET /v2/tenant-apps/{appId}/versions to see its available versions

## Query parameters

- `limit` number
- `offset` number
- `platform` 'APPLE' | 'WINDOWS'
- `package_name` string
- `app_name` string

## Response `200`

Success

- object
  - `content` object
    - `count` integer — number of results returned
    - `prev` string — URL for previous page of results
    - `next` string — URL for next page of results
    - `results` AppsManagementTenantAppResponse[]
      - `id` string
      - `platform` 'APPLE' | 'WINDOWS'
      - `tenant_id` string
      - `package_name` string
      - `created_at` string, date-time
      - `created_by` string
      - `updated_at` string, date-time
      - `updated_by` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `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/revisions/e1f64cbb488e/schema)