---
title: "Analyze Nutrition Facts Label"
method: POST
path: "/nutrition_records/ingredients/label"
tags: ["Nutrition AI"]
---

# Analyze Nutrition Facts Label

`POST /nutrition_records/ingredients/label`

##### Upload an image of a nutritional facts label to analyze it.

The system uses OCR (Optical Character Recognition) powered by AI to extract nutrition details from nutritional facts label image.
The results with nutritional fields like total fat, protein, etc. are structurized and presented as one ingredient in the JSON response.

### Processing Flow

The processing of nutrition facts label analysis is synchronous. No webhooks will be sent.

### Analysis Modes

- **`precise`** (default) — uses advanced AI models for the highest accuracy and detail with good processing time
- **`fast`** — uses optimized AI models for good accuracy and detail with the fastest processing time

### Nutritional fields

A predefined list of nutritional fields is extracted. See **[Nutritional Fields](/technical-references/nutritional_fields)** for supported macronutrients and micronutrients.

### Localization

For more documentation, including implementation examples, processing workflows, and integration guides, see **[Implementation Guide](/nutrition-ai/implementation)**.

## Request body

- NutritionIngredientLabelInput
  - `analysis_mode` 'fast' | 'precise' — A preferred mode for the analysis
  - `body` string — Base64-encoded binary data, this or 'body_url' is required
  - `body_url` string — URL to the image, this or 'body' is required

## Response `200`

OK

- NutritionIngredient
  - `failure_reason` string — Reason for processing failure
  - `name` string, required — Detected ingredient name
  - `nutritional_fields` object — Nutritional values in the given serving size
    - `calcium_mg` number — Calcium in milligrams
    - `carbohydrate_g` number — Carbohydrates in grams
    - `cholesterol_mg` number — Cholesterol in milligrams
    - `energy_kcal` number — Energy in kilocalories
    - `fat_monounsaturated_g` number — Monounsaturated Fat in grams
    - `fat_polyunsaturated_g` number — Polyunsaturated Fat in grams
    - `fat_saturated_g` number — Saturated Fat in grams
    - `fat_total_g` number — Total Fat in grams
    - `fat_trans_g` number — Trans Fat in grams
    - `fiber_total_dietary_g` number — Dietary Fiber in grams
    - `folate_mcg` number — Folate in micrograms
    - `iron_mg` number — Iron in milligrams
    - `magnesium_mg` number — Magnesium in milligrams
    - `manganese_mcg` number — Manganese in micrograms
    - `niacin_mg` number — Niacin in milligrams
    - `phosphorus_mg` number — Phosphorus in milligrams
    - `potassium_mg` number — Potassium in milligrams
    - `protein_g` number — Protein in grams
    - `riboflavin_mg` number — Riboflavin in milligrams
    - `salt_g` number — Salt in grams
    - `salt_mg` number — Salt in milligrams
    - `sodium_g` number — Sodium in grams
    - `sodium_mg` number — Sodium in milligrams
    - `sugars_total_g` number — Total Sugars in grams
    - `thiamin_mg` number — Thiamin in milligrams
    - `vitamin_a_rae_mcg` number — Vitamin A in micrograms
    - `vitamin_b12_mcg` number — Vitamin B12 in micrograms
    - `vitamin_b6_mg` number — Vitamin B6 in milligrams
    - `vitamin_c_mg` number — Vitamin C in milligrams
    - `vitamin_d_mcg` number — Vitamin D in micrograms
    - `vitamin_e_mg` number — Vitamin E in milligrams
    - `vitamin_k_mcg` number — Vitamin K in micrograms
    - `zinc_mg` number — Zinc in milligrams
  - `serving_size` number, double, required — Serving size in metric units
  - `status` 'completed' | 'failed' — Processing status
  - `unit` 'g' | 'mg' | 'mcg' | 'ml' | 'kcal', required — Metric unit (g for solids, ml for liquids)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/spikeapi/apis/application-user-api.md) · [All operations](https://skmtc.dev/spikeapi/apis/application-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spikeapi/application-user-api/revisions/637338fb0c9d/schema)