Sign in
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.

get/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

Query parameters

fdcIdsstring[] required

List of multiple FDC ID's. Should be comma separated list (e.g. fdcIds=534358,373052) or repeating parameters (e.g. fdcIds=534358&fdcIds=373052).

[
  534358,
  373052,
  616350
]
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. Should be comma separated list (e.g. nutrients=203,204) or repeating parameters (e.g. nutrients=203&nutrients=204). If a food does not have any matching nutrients, the food will be returned with an empty foodNutrients element.

[
  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.