---
title: "List mockup backdrops"
method: GET
path: "/mockup-backdrops"
tags: ["Surveys"]
---

# List mockup backdrops

`GET /mockup-backdrops`

## Request

- Base URL: `https://api.pickfu.com/v1`
- URL: `https://api.pickfu.com/v1/mockup-backdrops`
- Auth: HTTP bearer

Lists the shelf photos a shelf mockup template can draw products onto: PickFu's gallery and your team's own, each with its frozen image and its shelf lines. Name one on every option of a question as the template's `backdrop` value; every option of a question uses the same one.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Default Response

- object
  - `backdrops` object[], required
    - `id` string, required: The backdrop's id; send it as a shelf template's `mockup.values.backdrop`.
    - `name` string, nullable, required
    - `scope` 'gallery' | 'team', required: `gallery` for PickFu's backdrops, which every team can use; `team` for your team's own.
    - `imageUrl` string, required: The photo, frozen on PickFu's media CDN
    - `width` integer, required: Image pixels
    - `height` integer, required: Image pixels
    - `shelves` object[], required: Each shelf's front edge, top to bottom, as fractions of the image: `y` down from the top, `left` and `right` across.
      - `y` number, required
      - `left` number, required
      - `right` number, required
    - `createdAt` string, date-time, required
  - `pagination` object, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required
    - `hasMore` boolean, required

## Other responses

- `401`: Default Response
- `403`: Default Response

---

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