---
title: "List Catalog Foods"
method: GET
path: "/api/v1/catalog/foods"
tags: ["catalog"]
---

# List Catalog Foods

`GET /api/v1/catalog/foods`

## Request

- Base URL: `https://calorieapiadmin.com`
- URL: `https://calorieapiadmin.com/api/v1/catalog/foods`
- Auth: none declared

List food metadata only (no nutrients). Higher limit than /foods/.

## Query parameters

- `limit` integer
- `skip` integer
- `q` string, nullable: Search name/description
- `query` string, nullable: Alias for q
- `brand` string, nullable
- `brand_id` integer, nullable
- `category` string, nullable
- `category_id` integer, nullable
- `nutrient_id` integer, nullable
- `min_amount` number, nullable
- `max_amount` number, nullable
- `min_calories` number, nullable
- `max_calories` number, nullable
- `min_protein` number, nullable
- `max_protein` number, nullable
- `min_carbs` number, nullable
- `max_carbs` number, nullable
- `min_fat` number, nullable
- `max_fat` number, nullable

## Headers

- `X-API-Key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- PaginatedResponseCatalogFood
  - `data` CatalogFood[], required
    - `id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `brand_id` integer, nullable
    - `category_id` integer, nullable
    - `brand_name` string, nullable
    - `category_name` string, nullable
    - `serving_size` number, nullable
    - `serving_unit` string, nullable
    - `serving` string, nullable
    - `external_id` string, nullable
    - `is_verified` boolean, nullable
    - `created_at` string, date-time, nullable
    - `default_portion` PortionInfo: A serving portion with gram weight and display label.
      - `grams` number, required
      - `label` string, required
    - `portions_count` integer
    - `verified_portions` PortionInfo[], nullable
      - `grams` number, required
      - `label` string, required
    - `suggested_serving` PortionInfo: A serving portion with gram weight and display label.
      - `grams` number, required
      - `label` string, required
  - `total` integer, required
  - `skip` integer, required
  - `limit` integer, required

## Other responses

- `422`: Validation Error

---

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