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

# Get instance of wallpaper

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

Returns the details of a single wallpaper image identified by its UUID wallpaper_id, including the full-resolution image URL, thumbnail URL, orientation, and active status. There is no dedicated wallpaper library in the Console — wallpapers are only visible by previewing the blueprint they are associated with, making this endpoint the primary way to retrieve details for a specific wallpaper programmatically.

**Response fields of note**

id — UUID identifying the wallpaper

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

Retrieving wallpaper details to confirm a successful upload before referencing the wallpaper_id in a blueprint

Auditing the metadata of a specific wallpaper when the wallpaper_id is already known

Verifying the orientation or active status of a wallpaper before assigning it to a Windows blueprint

**Best Practices**

If the wallpaper_id is not already known, use GET /v1/enterprise/{enterprise_id}/wallpaper/ with timestamp filters to locate it — wallpapers are not browsable in the Console

This endpoint returns metadata and image URLs only; the image itself must be accessed directly via the image_file URL in the response

## Path parameters

- `enterprise_id` string, required
- `wallpaper_id` string, required

## Response `200`

successful operation

- EsperCloudApiWallpaper
  - `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)