---
title: "Get list of wallpapers"
method: GET
path: "/v1/enterprise/{enterprise_id}/wallpaper/"
tags: ["esper_cloud_api_Wallpapers"]
---

# Get list of wallpapers

`GET /v1/enterprise/{enterprise_id}/wallpaper/`

Returns a paginated list of all wallpaper images uploaded to the enterprise. Each result includes the image URL, thumbnail URL, orientation, and active status. Wallpapers can be uploaded directly via the API or may have been added through a blueprint configuration.

**Response fields of note**

id — UUID identifying the wallpaper; used to reference it in Windows blueprint wallpaper settings

image_file — URL of the full-resolution wallpaper image

thumbnail — URL of the thumbnail preview

orientation — Orientation of the image (e.g., landscape)

is_active — Whether the wallpaper is currently active

created_on / updated_on — Timestamps for auditing purposes

**Common Use Cases**

Discovering wallpaper_id values to reference in Windows blueprint homescreen or lock screen wallpaper settings

Verifying a wallpaper was successfully uploaded before referencing it in a blueprint

Building wallpaper selection UIs in custom management tools

**Best Practices**

Use timestamp filters to scope results when auditing recently added or modified wallpapers rather than fetching the full list

Store wallpaper_id UUIDs for use in Windows blueprint configuration — the wallpaper_id field appears in both homescreen and lock screen landscape settings

Note that wallpapers uploaded as part of a blueprint configuration will also appear in this list and can be reused across multiple blueprints

## Path parameters

- `enterprise_id` string, required

## Query parameters

- `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` EsperCloudApiWallpaper[], required
    - `id` string, uuid
    - `enterprise` string, uuid
    - `image_file` string, url
    - `thumbnail` string, url
    - `orientation` string
    - `is_active` boolean
    - `created_on` string, date-time
    - `updated_on` string, date-time

## Other responses

- `401` — Authorization information is missing or invalid.
- `404` — Not Found.
- `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)