---
title: "Calculate a cached food portion from grams"
method: GET
path: "/v1/foods/portion"
tags: ["foods"]
---

# Calculate a cached food portion from grams

`GET /v1/foods/portion`

## Request

- Base URL: `http://localhost:4318`
- URL: `http://localhost:4318/v1/foods/portion`
- Auth: HTTP bearer

## Query parameters

- `id` string, required
- `grams` number, required

## Response `200`

Success

- FoodItem
  - `calories` number, required
  - `protein` number, required
  - `carbs` number, required
  - `fat` number, required
  - `id` string, required
  - `name` string, required
  - `grams` number, nullable, required
  - `preparation` string
  - `emoji` string
  - `source` string, required
  - `sourceUrl` string, uri
  - `basis` 'database' | 'estimate' | 'measured', required
  - `calorieLow` number, required
  - `calorieHigh` number, required

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid bearer token
- `409`: Revision or idempotency conflict
- `429`: Rate limit exceeded

---

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