---
title: "Foods and nutrients per 100 g"
method: GET
path: "/v1/foods"
---

# Foods and nutrients per 100 g

`GET /v1/foods`

## Request

- Base URL: `https://api.aleva.se`
- URL: `https://api.aleva.se/v1/foods`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `name` string
- `name.prefix` string
- `food_id` integer
- `food_id.in` string
- `protein_g.gte` number
- `protein_g.lte` number
- `fibre_g.gte` number
- `fibre_g.lte` number
- `energy_kcal.gte` number
- `energy_kcal.lte` number
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `_meta` Meta, required
    - `attribution` string
    - `build_run_id` integer
    - `built_at` string, date-time
    - `endpoint` string
    - `fetched_at` string, date-time
    - `licenses` string[]
    - `sources` object[]
    - `usage_mode` string
    - `version` integer
  - `data` object[], required
    - `calcium_mg` number
    - `carbohydrates_g` number
    - `energy_kcal` number
    - `fat_g` number
    - `fibre_g` number
    - `food_id` integer
    - `iron_mg` number
    - `kind` string
    - `name` string
    - `protein_g` number
    - `salt_g` number
    - `saturated_fat_g` number
    - `sugars_g` number
    - `vitamin_c_mg` number
    - `vitamin_d_ug` number
  - `next_cursor` string: Present when there are more rows

## Other responses

- `400`: Invalid parameters
- `401`: Missing or invalid API key
- `404`: Not found
- `429`: Rate limit reached

---

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