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

# List Foods

`GET /api/v1/foods/`

## Request

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

List foods with optional filtering and search (metadata only, no nutrients).

## Query parameters

- `limit` integer
- `skip` integer
- `brand` string, nullable: Filter by brand name
- `brand_id` integer, nullable
- `category` string, nullable: Filter by category name
- `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
- `query` string, nullable

## Headers

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

## Response `200`

Successful Response

- PaginatedResponse: Generic paginated response model
  - `data` unknown[], required
    - unknown
  - `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)