Skip to main content
List Nutrition Records
curl --request GET \
  --url https://app-api.spikeapi.com/v3/nutrition_records \
  --header 'Authorization: Bearer <token>'
[
  {
    "modified_at": "2023-11-07T05:31:56Z",
    "record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "pending",
    "uploaded_at": "2023-11-07T05:31:56Z",
    "consumed_at": "2023-11-07T05:31:56Z",
    "dish_description": "<string>",
    "dish_description_translated": "<string>",
    "dish_name": "<string>",
    "dish_name_translated": "<string>",
    "failure_reason": "<string>",
    "ingredients": [
      {
        "name": "<string>",
        "serving_size": 123,
        "unit": "g",
        "name_translated": "<string>",
        "nutritional_fields": {
          "calcium_mg": 123,
          "carbohydrate_g": 123,
          "cholesterol_mg": 123,
          "energy_kcal": 123,
          "fat_monounsaturated_g": 123,
          "fat_polyunsaturated_g": 123,
          "fat_saturated_g": 123,
          "fat_total_g": 123,
          "fat_trans_g": 123,
          "fiber_total_dietary_g": 123,
          "folate_mcg": 123,
          "iron_mg": 123,
          "magnesium_mg": 123,
          "niacin_mg": 123,
          "phosphorus_mg": 123,
          "potassium_mg": 123,
          "protein_g": 123,
          "riboflavin_mg": 123,
          "sodium_mg": 123,
          "sugars_total_g": 123,
          "thiamin_mg": 123,
          "vitamin_a_rae_mcg": 123,
          "vitamin_b12_mcg": 123,
          "vitamin_b6_mg": 123,
          "vitamin_c_mg": 123,
          "vitamin_d_mcg": 123,
          "vitamin_e_mg": 123,
          "vitamin_k_mcg": 123,
          "zinc_mg": 123
        }
      }
    ],
    "nutri_score": "<string>",
    "nutritional_fields": {
      "calcium_mg": 123,
      "carbohydrate_g": 123,
      "cholesterol_mg": 123,
      "energy_kcal": 123,
      "fat_monounsaturated_g": 123,
      "fat_polyunsaturated_g": 123,
      "fat_saturated_g": 123,
      "fat_total_g": 123,
      "fat_trans_g": 123,
      "fiber_total_dietary_g": 123,
      "folate_mcg": 123,
      "iron_mg": 123,
      "magnesium_mg": 123,
      "niacin_mg": 123,
      "phosphorus_mg": 123,
      "potassium_mg": 123,
      "protein_g": 123,
      "riboflavin_mg": 123,
      "sodium_mg": 123,
      "sugars_total_g": 123,
      "thiamin_mg": 123,
      "vitamin_a_rae_mcg": 123,
      "vitamin_b12_mcg": 123,
      "vitamin_b6_mg": 123,
      "vitamin_c_mg": 123,
      "vitamin_d_mcg": 123,
      "vitamin_e_mg": 123,
      "vitamin_k_mcg": 123,
      "zinc_mg": 123
    },
    "serving_size": 123,
    "unit": "g"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
from_timestamp
string<date-time>
required

Start time of the query range in UTC, inclusive

Examples:

"2006-01-02T15:04:05"

"2006-01-02T15:04:05Z"

​
to_timestamp
string<date-time>
required

End time of the query range in UTC, non-inclusive

Examples:

"2006-01-02T15:04:05"

"2006-01-02T15:04:05Z"

Response

object[] | null

OK

​
modified_at
string<date-time>
required

Update timestamp in UTC

Example:

"2025-09-15T10:30:12.132Z"

​
record_id
string<uuid>
required

Report record ID

Example:

"6ba7b810-9dad-11d1-80b4-00c04fd430c8"

​
status
enum<string>
required

Processing status

Available options:
pending,
processing,
completed,
failed
Example:

"completed"

​
uploaded_at
string<date-time>
required

Upload timestamp in UTC

Example:

"2025-09-15T10:30:04.521Z"

​
consumed_at
string<date-time>

The UTC time when food was consumed

Example:

"2025-09-15T08:15:00Z"

​
dish_description
string

Detected dish description

Example:

"beef, ground, lean, cooked with broccoli, raw and rice, brown, cooked"

​
dish_description_translated
string

Dish description translated to target language

Example:

"Rindfleisch, Hackfleisch, mager, gekocht mit Brokkoli, roh und Reis, braun, gekocht"

​
dish_name
string

Detected dish name

Example:

"beef and broccoli stir-fry"

​
dish_name_translated
string

Dish name translated to target language

Example:

"Rindfleisch und Brokkoli Pfanne"

​
failure_reason
string

Reason for processing failure

Example:

"Unable to identify food items"

​
ingredients
object[] | null

List of detected ingredients with nutritional information

​
nutri_score
string

Nutri-Score known as the 5-Colour Nutrition label (A-E)

Example:

"B"

​
nutritional_fields
object

Nutritional values per 100 g/ml

​
serving_size
number<double>

Serving size in metric units

Example:

120

​
unit
enum<string>

Metric unit (g for solids, ml for liquids)

Available options:
g,
mg,
mcg,
ml,
kcal
Example:

"g"