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

# Get esper apps for a tenant

`GET /v2/tenant-esper-apps`

Retrieves a paginated list of Esper-provided apps available to the tenant.

Returns each app's TenantEsperAppsItem record, filterable by package name, version code, and architecture.

**About Get Esper Apps**

Esper Apps are apps published by Esper itself, rather than uploaded by the tenant, and made available for installation on managed devices, such as Windows-side utility or agent apps. This catalog is separate from Tenant Apps (tenant-uploaded iOS and Windows apps) and from Android's Application V1 catalog.

**Key Fields / Query Parameters**

package_name — filters by package name

architecture — filters by CPU architecture, for example x86_64, arm64_v8a, or universal

version_code — filters by a specific version code

ordering — orders by created_at or version_code, ascending or descending

**Common Use Cases**

Browsing available Esper-provided apps before assigning one to a device or blueprint

Finding the correct architecture-specific build of an Esper app for a device

**Best Practices**

Filter by architecture to avoid selecting a build incompatible with the target device's hardware

**Workflow**

Call this endpoint with the filters relevant to the app you need

Identify the correct version_code and architecture for your target devices

Reference the app in a blueprint or command to install it

## Query parameters

- `limit` number
- `offset` number
- `package_name` string
- `ordering` 'created_at (ascending)' | '-created_at (descending)' | 'version_code (ascending)' | '-version_code (descending)'
- `architecture` 'x86' | 'x86_64' | 'armeabi' | 'arm64_v8a' | 'armeabi_v7a' | 'universal'
- `version_code` string — Filter by version code

## 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` AppsManagementTenantEsperAppsItem[]
      - `tenant_id` string
      - `app_version_id` string
      - `app_id` string
      - `package_name` string — Package name of the app (only shown for Android apps)
      - `app_sha256_hash` string
      - `signature_hash` string — Signature hash of the app (only shown for Android apps)
      - `architecture` string
      - `app_download_url` string
      - `version_code` string — Version code of the app (only shown for Android apps)
      - `created_by` string
      - `created_at` string, date-time

## 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)