---
title: "Wait for the user's pick"
method: GET
path: "/api/v1/picks/{pickId}"
tags: ["picks"]
---

# Wait for the user's pick

`GET /api/v1/picks/{pickId}`

## Request

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

Wait for the user to choose on the pick page. Long-polls up to 50 seconds—returns as soon as
they click, or status "pending" after the wait (call again if so).

Once chosen, returns their reference with its screenshot and a full build prompt, so you can
start building from it immediately. If they clicked "None of these fit", status is "dismissed"
and you should ask what they want instead.

## Path parameters

- `pickId` string, required

## Query parameters

- `wait` integer

## Response `200`

The pick's status and, once chosen, the reference and build prompt.

- PickResult
  - `pickId` string
  - `status` 'pending' | 'chosen' | 'dismissed'
  - `message` string
  - `choice` 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
  - `prompt` string: Build prompt for the chosen reference.

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