FDC

Returns a paged list of foods, in the 'abridged' format

Retrieves a paged list of foods. Use the pageNumber parameter to page through the entire result set.

post/v1/foods/list

Request

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

Request body

dataTypestring[]

Optional. Filter on a specific data type; specify one or more values in an array.

pageSizeinteger

Optional. Maximum number of results to return for the current page. Default is 50.

pageNumberinteger

Optional. Page number to retrieve. The offset into the overall result set is expressed as (pageNumber * pageSize)

sortBy'dataType.keyword' | 'lowercaseDescription.keyword' | 'fdcId' | 'publishedDate'

Optional. Specify one of the possible values to sort by that field. Note, dataType.keyword will be dataType and lowercaseDescription.keyword will be description in future releases.

sortOrder'asc' | 'desc'

Optional. The sort direction for the results. Only applicable if sortBy is specified.

Example request

{
  "dataType": [
    "Foundation",
    "SR Legacy"
  ],
  "pageSize": 25,
  "pageNumber": 2
}

Response

List of foods for the requested page

dataTypestring required
descriptionstring required
fdcIdinteger required
publicationDatestring
brandOwnerstring

only applies to Branded Foods

gtinUpcstring

only applies to Branded Foods

ndbNumberstring

only applies to Foundation and SRLegacy Foods

foodCodestring

only applies to Survey Foods

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.