---
title: "Get one screen"
method: GET
path: "/api/v1/screens/{screenId}"
tags: ["screens"]
---

# Get one screen

`GET /api/v1/screens/{screenId}`

## Request

- Base URL: `https://screenrove.com`
- URL: `https://screenrove.com/api/v1/screens/{screenId}`
- Auth: none declared

Get everything recorded about one screen: notes on what it does and how it's laid out, source
URL, image URLs and dimensions, observed actions and where they lead, and page sections for
long marketing pages.

Use this to understand a specific UI pattern in detail before building something similar.

## Path parameters

- `screenId` string, required

## Response `200`

The screen.

- Screen
  - `id` string
  - `product` string
  - `kind` 'flow' | 'marketing' | 'product': flow is an onboarding step, marketing a public web page, product an in-app screen.
  - `title` string
  - `notes` string
  - `imageUrl` string
  - `previewUrl` string: Screen-sized preview (the top of long pages). Present on pick options.
  - `productName` string: Present on pick options.
  - `source` string
  - `captured` string, date
  - `width` integer
  - `height` integer
  - `branch` boolean
  - `actions` object[]
    - `label` string
    - `to` string
    - `region` object: Hotspot position as percentages of the image.
      - `x` number
      - `y` number
      - `width` number
      - `height` number
  - `sections` object[]
    - `title` string
    - `y` integer

## Other responses

- `404`: No product, screen or reference with that id.

---

[API](https://skmtc.dev/screenrove/apis/screenrove-api.md) · [All operations](https://skmtc.dev/screenrove/apis/screenrove-api/llms.txt) · [OpenAPI document](https://skmtc.dev/screenrove/apis/screenrove-api/revisions/9383a872c966?raw)