FoodData Central · Example Payload

Get Food By Fdc Id

Example request and response for retrieving a single branded food item using GET /v1/food/{fdcId}

FoodNutritionUSDAGovernmentHealthDietNutrientsPublic Domain

Get Food By Fdc Id is an example object payload from FoodData Central, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

summarydescriptionrequestresponse

Example Payload

Raw ↑
{
  "summary": "Get a branded food item by FDC ID",
  "description": "Example request and response for retrieving a single branded food item using GET /v1/food/{fdcId}",
  "request": {
    "method": "GET",
    "url": "https://api.nal.usda.gov/fdc/v1/food/534358?api_key=DEMO_KEY",
    "parameters": {
      "fdcId": "534358",
      "format": "full",
      "api_key": "DEMO_KEY"
    }
  },
  "response": {
    "status": 200,
    "body": {
      "fdcId": 534358,
      "dataType": "Branded",
      "description": "NUT 'N BERRY MIX",
      "brandOwner": "Kar Nut Products Company",
      "gtinUpc": "077034085228",
      "ingredients": "PEANUTS (PEANUTS, PEANUT AND/OR SUNFLOWER OIL). RAISINS. DRIED CRANBERRIES (CRANBERRIES, SUGAR, SUNFLOWER OIL). SUNFLOWER KERNELS AND ALMONDS (SUNFLOWER KERNELS AND ALMONDS, PEANUT AND/OR SUNFLOWER OIL).",
      "servingSize": 28,
      "servingSizeUnit": "g",
      "householdServingFullText": "1 ONZ",
      "brandedFoodCategory": "Popcorn, Peanuts, Seeds & Related Snacks",
      "availableDate": "8/18/2018",
      "modifiedDate": "8/18/2018",
      "publicationDate": "4/1/2019",
      "foodClass": "Branded",
      "dataSource": "LI",
      "labelNutrients": {
        "fat": { "value": 8.9992 },
        "saturatedFat": { "value": 0.9996 },
        "transFat": { "value": 0 },
        "cholesterol": { "value": 0 },
        "sodium": { "value": 0 },
        "carbohydrates": { "value": 12.0008 },
        "fiber": { "value": 1.988 },
        "sugars": { "value": 7.9996 },
        "protein": { "value": 4.0012 },
        "calcium": { "value": 19.88 },
        "iron": { "value": 0.7196 },
        "postassium": { "value": 159.88 },
        "calories": { "value": 140 }
      },
      "foodNutrients": [
        {
          "id": 1008,
          "amount": 500,
          "type": "FoodNutrient",
          "nutrient": {
            "id": 1008,
            "number": "208",
            "name": "Energy",
            "rank": 300,
            "unitName": "kcal"
          }
        },
        {
          "id": 1005,
          "amount": 42.86,
          "type": "FoodNutrient",
          "nutrient": {
            "id": 1005,
            "number": "205",
            "name": "Carbohydrate, by difference",
            "rank": 1110,
            "unitName": "g"
          }
        },
        {
          "id": 1004,
          "amount": 32.14,
          "type": "FoodNutrient",
          "nutrient": {
            "id": 1004,
            "number": "204",
            "name": "Total lipid (fat)",
            "rank": 800,
            "unitName": "g"
          }
        },
        {
          "id": 1003,
          "amount": 14.29,
          "type": "FoodNutrient",
          "nutrient": {
            "id": 1003,
            "number": "203",
            "name": "Protein",
            "rank": 600,
            "unitName": "g"
          }
        }
      ]
    }
  }
}