---
title: "GET /api/public/food-items"
method: GET
path: "/api/public/food-items"
tags: ["Nutrition Menus"]
---

# GET /api/public/food-items

`GET /api/public/food-items`

Search the food database the dashboard searches: the shared catalog plus the coach's own items. Use it to build meals with real nutrition data — copy productCode, the per-100g macros and a unit/unitWeight pair onto each meal food item. Omit search and barcode to browse the catalog.

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `barcode` string

## Response `200`

Successful response

- object — Successful response
  - `data` object[]
    - `id` string
    - `productCode` number — Send this as productCode on a meal food item to link it to this entry.
    - `name` string
    - `manufacturer` string
    - `barcode` string
    - `caloriesPer100g` number
    - `proteinPer100g` number
    - `carbsPer100g` number
    - `fatPer100g` number
    - `isFavorite` boolean
    - `isCustom` boolean — True when the coach created this item, false when it comes from the shared database.
    - `units` object[] — Units this food can be measured in. unitWeight is how many grams one unit weighs — copy the pair onto a meal food item as unit + unitWeight.
      - `unit` string
      - `unitWeight` number
  - `pagination` object
    - `page` number
    - `limit` number
    - `total` number, nullable — Total number of matching items. null when the underlying source cannot report an exact count for this page; use hasMore to keep paging.
    - `hasMore` boolean
    - `truncated` boolean — Present and true when the result set exceeded the in-memory scan cap and was truncated. Narrow your filters to page through all items.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `429` — Default Response
- `500` — Default Response

---

[API](https://skmtc.dev/coach-platform/apis/coach-platform-api.md) · [All operations](https://skmtc.dev/coach-platform/apis/coach-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coach-platform/coach-platform-api/revisions/3d18b514ae8c/schema)