---
title: "Get webclips for a tenant"
method: GET
path: "/v2/webclips"
tags: ["apps_management_Webclips"]
---

# Get webclips for a tenant

`GET /v2/webclips`

⚠️ Apple devices only.

Retrieves a paginated list of all webclips in the tenant library, with optional filtering by label or internal Esper name.

**About List Webclips**

Returns Webclip records for all webclips uploaded to the tenant — the same resource created by POST /api/v2/webclips. Each record includes the webclip's UUID, label, URL, target bundle details, full-screen and removability flags, icon URL, and audit timestamps. The exact_esper_name filter performs an exact-match lookup on the internal esper_name field, useful for finding a specific webclip by its Esper identifier without paginating through the full list. For a unified view of webclips alongside IPA-based apps, use GET /api/v2/apps with app_type=WEBCLIP.

**Key Query Parameters**

label — Filter by webclip display label (partial match)

exact_esper_name — Exact-match filter on the internal esper_name field

**Common Use Cases**

Looking up a specific webclip's UUID by its esper_name for use in blueprint or operation configuration

Auditing all webclips in the tenant library before a deployment or cleanup operation

Verifying webclip details (URL, target bundle, removability) before assigning to a blueprint

**Best Practices**

Use exact_esper_name when you know the internal name — it is more precise than label and avoids ambiguity with similarly labeled webclips

Paginate with limit and offset for tenants with large webclip libraries

## Query parameters

- `limit` number
- `offset` number
- `label` string
- `exact_esper_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` AppsManagementWebclip[]
      - `id` string, uuid — Unique identifier for the web clip
      - `tenant_id` string, uuid — Tenant identifier
      - `label` string — Label of the web clip
      - `url` string, uri — URL associated with the web clip
      - `icon_url` string, uri, nullable — URL for the icon of the web clip
      - `target_bundle_name` string — Name of the target bundle
      - `target_bundle_id` string — ID of the target bundle
      - `is_full_screen` boolean — Indicates if the web clip is full screen
      - `is_removable` boolean — Indicates if the web clip is removable
      - `created_at` string, date-time — Timestamp of when the web clip was created
      - `updated_at` string, date-time — Timestamp of when the web clip was last updated
      - `created_by` string — The user who created the web clip
      - `updated_by` string — The user who last updated the web clip

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