Products API

Product API routes are served by apps/api under the Products tag.

Find many products

POST /api/products/find-many

Use this route to list products with the query shape accepted by the product query schema.

curl "$BETTERSTORE_API_URL/api/products/find-many" \
  -H "Authorization: Bearer $BETTERSTORE_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{}'

Find first product

POST /api/products/find-first

Use this route to retrieve the first product matching the product query schema.

curl "$BETTERSTORE_API_URL/api/products/find-first" \
  -H "Authorization: Bearer $BETTERSTORE_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{}'

Notes

• Product responses use the full product response schema where available.
• Query behavior should remain compatible with the API query parser and existing product service.
• Product mutations are currently handled by platform workflows rather than these public query routes.