FDC

Fetches details for multiple food items using input FDC IDs

Retrieves a list of food items by a list of up to 20 FDC IDs. Optional format and nutrients can be specified. Invalid FDC ID's or ones that are not found are omitted and an empty set is returned if there are no matches.

post/v1/foods

Request

Base URL: https://api.nal.usda.gov/fdc
URL: https://api.nal.usda.gov/fdc/v1/foods
Auth: API key in query parameter api_key

Request body

fdcIdsinteger[]

List of multiple FDC ID's

format'abridged' | 'full'

Optional. 'abridged' for an abridged set of elements, 'full' for all elements (default).

nutrientsinteger[]

Optional. List of up to 25 nutrient numbers. Only the nutrient information for the specified nutrients will be returned. If a food does not have any matching nutrients, the food will be returned with an empty foodNutrients element.

Example request

{
  "fdcIds": [
    534358,
    373052,
    616350
  ],
  "nutrients": [
    203,
    204,
    205
  ]
}

Response

List of Food details matching specified FDC ID's. Invalid FDC ID's or ones that are not found are omitted.

Example response

[
  {
    "dataType": "Branded",
    "description": "NUT 'N BERRY MIX",
    "fdcId": 534358,
    "foodNutrients": [
      {
        "number": 303,
        "name": "Iron, Fe",
        "amount": 0.53,
        "unitName": "mg",
        "derivationCode": "LCCD",
        "derivationDescription": "Calculated from a daily value percentage per serving size measure"
      }
    ],
    "publicationDate": "4/1/2019",
    "brandOwner": "Kar Nut Products Company",
    "gtinUpc": "077034085228",
    "ndbNumber": "7954",
    "foodCode": "27415110"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.