---
title: "Get a screen"
method: GET
path: "/screens/{screen_id}"
tags: ["Screens"]
---

# Get a screen

`GET /screens/{screen_id}`

Returns a single screen by ID.

By default the response is the full `V4Screen`, including the render-time fields (`background`, `default_lang`, `configs`, `content`, `prod_key`, `sandbox_key`, `used`) an SDK needs to display a paywall.

Pass `render=false` to receive the lean `V4ScreenSummary` instead — the same shape returned on `GET /v4/screens`. Useful when you only need metadata and want to avoid fetching the render payload, which can be several kilobytes per screen.

## Path parameters

- `screen_id` string, required

## Query parameters

- `render` boolean

## Response `200`

Screen details. The response is a `V4Screen` when `render=true` (default) or a `V4ScreenSummary` when `render=false`.

- union
  - V4Screen — Lean screen representation used on list endpoints. Omits render-time fields (`configs`, `content`, `prod_key`, `sandbox_key`, `used`, etc.) to keep paginated walks cheap. Fetch `V4Screen` via `GET /v4/screens/{screen_id}` for the full render payload.
    - `object` 'screen', required
    - `id` string, required
    - `url` string, required
    - `name` string, required
    - `status` string, required
    - `type` string, nullable
    - `context_key` string, nullable
    - `is_web` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `background` string, nullable, required — CSS background for the paywall root element.
    - `default_lang` string, nullable, required — Default localisation key. When the SDK can't match the user's locale it falls back to this language.
    - `configs` unknown, required
    - `prod_key` string, nullable, required — SDK integration key used in production builds. Load-bearing — the SDK cannot render the screen without it.
    - `sandbox_key` string, nullable, required — SDK integration key for sandbox / test builds.
    - `content` unknown, required
    - `used` string[], required — UIDs of triggers currently targeting this screen.
  - V4ScreenSummary — Lean screen representation used on list endpoints. Omits render-time fields (`configs`, `content`, `prod_key`, `sandbox_key`, `used`, etc.) to keep paginated walks cheap. Fetch `V4Screen` via `GET /v4/screens/{screen_id}` for the full render payload.
    - `object` 'screen', required
    - `id` string, required
    - `url` string, required
    - `name` string, required
    - `status` string, required
    - `type` string, nullable
    - `context_key` string, nullable
    - `is_web` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400` — Invalid screen_id
- `401` — Unauthorized
- `403` — Insufficient permissions
- `404` — Screen not found
- `500` — Internal error
- `502` — Upstream service failure
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)