---
title: "首周食材清单(不带价格),量按同住人数档;有孩 / 有宠各加一组。"
method: GET
path: "/v1/lists/pantry"
tags: ["life_setup"]
---

# 首周食材清单(不带价格),量按同住人数档;有孩 / 有宠各加一组。

`GET /v1/lists/pantry`

## Request

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

首周食材清单(不带价格),量按同住人数档;有孩 / 有宠各加一组。

## Query parameters

- `household` '1' | '2' | '3+'
- `kids` boolean
- `pets` boolean

## Response `200`

OK

- object
  - `source` unknown, required
  - `fetched_at` string, date-time, required
  - `tier` '1' | '2' | '3+', required
  - `kids` boolean, required
  - `pets` boolean, required
  - `items` object[], required
    - `id` string, required
    - `zh` string, required
    - `en` string, required
    - `q` string, required: 站内搜索词
    - `cat` string, required
    - `qty` number, required
    - `unit` string
  - `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)