Nutrients

A Nutrient is the basic building block of a Food Analysis or Recommendation. It comprises food energy (e.g., calories), macronutrients (e.g., protein, carbohydrates), and synthetic elements (e.g., MyPlate groups). This resource provides a listing of all Nutrients supported by the API.

Resource URI

/nutrients

Resource Properties

This resource is represented as an array of objects with the following fields:

NameTypeDescription
id string The unique identifier of the nutrient
description string A human-readable description of the nutrient
unit string The implied unit of the nutrient
unitId string The URI of the nutrient's default unit

Supported Operations

List Nutrients (HTTP GET)

HTTP GET returns a JSON document containing all known nutrients.

Example Request

GET /nutrients?apikey=d9eea4cc28c342a2a7fc49d307860c03
Accept: application/json

Example Response

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "id": "urn:uuid:a4d01e46-5df2-4cb3-ad2c-6b438e79e5b9",
    "description": "Calories",
    "unit": "kcal",
    "unitId": "urn:uuid:a7df0af5-edb2-0002-7484-751e8eaf05c6"
  },
  {
    "id": "urn:uuid:666ae7df-af65-4d55-8d5f-996e6cc384ca",
    "description": "Protein",
    "unit": "g",
    "unitId": "urn:uuid:d3be684c-ebfa-4861-924f-8840600d1e84"
  },
  {
    "id": "urn:uuid:975a8d10-8650-4e0c-9a8f-7f4aaa6ae9e2",
    "description": "Carbohydrates",
    "unit": "g",
    "unitId": "urn:uuid:d3be684c-ebfa-4861-924f-8840600d1e84"
  },
  ...
]