---
title: "List Products"
method: GET
path: "/api/products"
tags: ["Products"]
---

# List Products

`GET /api/products`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/products`
- Auth: none declared. Required headers: `authorization`

List products in the shop's catalog.

q を渡すと item_name / learned_summary / platform_item_id を横断 ilike 検索する
(全件サーバー検索・ページング対応)。

## Query parameters

- `status` string, nullable: Filter by learning_status
- `q` string, nullable: 商品名/要約/商品IDの横断検索 (ilike)
- `limit` integer
- `offset` integer

## Headers

- `x-shop-id` string, nullable: Optional shop ID
- `authorization` string, required: Bearer <token>

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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