---
title: "按房型 × 预算档出家具清单(不带价格);sqft 给了就把放不下的丢进 dropped。"
method: GET
path: "/v1/lists/furniture"
tags: ["life_setup"]
---

# 按房型 × 预算档出家具清单(不带价格);sqft 给了就把放不下的丢进 dropped。

`GET /v1/lists/furniture`

## Request

- Base URL: `https://www.putroots.com`
- URL: `https://www.putroots.com/v1/lists/furniture`
- Auth: HTTP bearer

按房型 × 预算档出家具清单(不带价格);sqft 给了就把放不下的丢进 dropped。

## Query parameters

- `rooms` 'studio' | '1b' | '2b'
- `budget` 'low' | 'mid' | 'high'
- `sqft` number

## Response `200`

OK

- object
  - `source` unknown, required
  - `fetched_at` string, date-time, required
  - `room` 'studio' | '1b' | '2b', required
  - `budget` 'low' | 'mid' | 'high', required
  - `sqft` number, nullable, required
  - `items` object[], required
    - `id` string, required
    - `zh` string, required
    - `en` string, required
    - `q` string, required: 站内搜索词
    - `cat` string, required
    - `qty` number, required
    - `footprint_in` number[]
    - `note_zh` string
    - `note_en` string
  - `dropped` object[], required
    - `id` string, required
    - `zh` string, required
    - `en` string, required
    - `min_sqft` number, required
  - `list_source` string, required: 清单来源标识
  - `list_updated` string, required: 清单的 updated(YYYY-MM-DD)

## Other responses

- `400`: Bad input — error says which field.
- `401`: No key / bad token.
- `403`: Key is fine but not for this: pending approval, revoked, scope missing, or an operation only the renter's own account may call.
- `404`: No such lead / hand-off / listing under this key.
- `409`: Conflict: the code is already registered.
- `429`: Rate limited; Retry-After in seconds.

---

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