GET Beef Cuts By List

Calls to this endpoint will return a summary list of beef cuts based on a given list of beef cut ingredient IDs.

The base URI for Get beef cuts by list is:

GET /api/v2/beefcut/list

Get Beef Cuts List By ID Parameters

Try This Endpoint on Swagger
Name Required Parameter Type Data Type
ingredientIDList path array
  An array or comma delimited list of beef cut ingredient IDs. These values must be integers.
AuthorizationAppID (optional) query string
  This value must be present in either the http header or in the query string. If you supply an incorrect value or do not supply a value in the header or query string, then you will receive a http 401 error. (Please see Authentication section)
AuthorizationAppKey (optional) query string
  This value must be present in either the http header or in the query string. If you supply an incorrect value or do not supply a value in the header or query string, then you will receive a http 401 error. (Please see Authentication section)

What it Returns

Requests to the Get beef cuts by list will return the following data:

Name & Description Type
  • BeefAPIIngredientSummaryListing object
    A container that holds the resulting list of beef cuts.
    • ingredientListing array
      A list of beef cut summary objects.
      • ingredientID int
        Unique identifier of the beef cut.
      • ingredientName string
        Name of the beef cut.
      • ingredientNameSlug string
        URL-friendly slugged name of the beef cut.
      • isOnline boolean
        Marker to denote if this beef cut is available on the Beef API.
      • lastModified datetime
        Date & time the object was last updated
      • ingredientText string
        General description of the beef cut.
      • ingredientMeta string
        Short, concise meta description of the beef cut.
      • isBeefIngredient boolean
        True if this is a beef ingredient.
      • isBeefPrimal boolean
        True if this is a primal beef cut.
      • isBeefSubprimal boolean
        True if this is a subprimal beef cut.
      • isBeefSubsection boolean
        True if this is a subsection beef cut.
      • isBeefFabricatedCut boolean
        True if this is a fabricated beef cut.
      • isLean boolean
        True if this is a lean beef cut.
      • isMarinate boolean
        True if this beef cut is suggested to marinate.
      • isRecipeIngredient boolean
        True if this beef cut is used in recipes.
      • grocerySection array
        The grocery section this beef cut can be found in. Object values found in this array will be an exact match to what can be found in the master list of grocerySections in the common endpoint (/api/v2/common/lookups).
        • grocerySectionName string
          Name of the grocery section.
        • grocerySectionNameSlug string
          URL-friendly slugged name of the grocery section.
      • ingredientType object
        The type of ingredient. Object values found in this array will be an exact match to what can be found in the master list of ingredientTypes in the common endpoint (/api/v2/common/lookups).
        • ingredientTypeName string
          Name of the ingredient type.
        • ingredientTypeNameSlug string
          URL-friendly slugged name of the ingredient type.
      • showcaseNutrients array
        A list of nutrients from this beef cuts primary nutritional that we suggest to highlight.
        • nutritionalType string
          The type of nutritional. This will be "raw" or "cooked."
        • usdaNutrient object
          The USDA nutrient object for the given nutrient. Object values found in this array will be an exact match to what can be found in the master list of usdaNutrients in the common endpoint (/api/v2/common/lookups).
          • usdaNutrientGroup string
            The food group of the nutrient.
          • nutrientDisplayName string
            The display name of the nutrient.
          • nutrientDisplayNameSlug string
            URL-friendly slugged name of the nutrient.
        • unitOfMeasureValue decimal
          The calculated unit of measure for the given nutrient.
        • unitOfMeasure string
          The unit of measure for the given nutrient.
        • dailyValueCalculation decimal
          The calculated daily value for this nutrient.
        • sortOrder int
          The preferred sort order for display of this nutrient.
        • isGoodSource boolean
          If the unitOfMeasureValue meets that USDA requirements for a "good" source of the given nutrient, this field will be true, else it will be false.
        • isExcellentSource boolean
          If the unitOfMeasureValue meets that USDA requirements for an "excellent" source of the given nutrient, this field will be true, else it will be false.
      • attributes array
        A list of attributes by type that pertain to this beef cut. Object values found in this array will be an exact match to what can be found in the master list of attributesByTypes in the common endpoint (/api/v2/common/lookups).
        • attributeTypeName string
          Name of the attribute type.
        • attributeTypeNameSlug string
          URL-friendly name of the attribute type.
        • objectType array
          The type object this attribute type pertains to. Object values found in this array will be an exact match to what can be found in the master list of object type in the common endpoint (/api/v2/common/lookups).
          • objectTypeName string
            The name of the object type this attribute type pertains to.
          • objectTypeNameSlug string
            URL-friendly slugged name of the type of object this attribute type pertains to.
        • attributes array
          A list of attributes that pertain to this beef cut attribute type.
          • attributeName string
            Name of the attribute.
          • attributeNameSlug string
            URL-friendly name of the attribute.
      • media array
        A list of media objects containing information about media assigned to this beef cut.
        • widenURL string
          This is the base part of the URL that is needed to build the embed link.
        • widenUID string
          This is the customer userid part of the URL that is needed to build the embed link.
        • externalID string
          This is the unique identifier of the media item.
        • filename string
          This is the filename of the media item.
        • title string
          This is the title of the media item.
        • caption string
          This is the caption used for the media item.
        • mediaGroup object
          Media will always be returned grouped and sorted. Use this grouping to help manage any groupings that may be suggested from the BeefAPI. Object values found in this array will be an exact match to what can be found in the master list of mediaGroups in the common endpoint (/api/v2/common/lookups).
          • mediaGroupName string
            Name of the media group.
          • mediaGroupNameSlug string
            URL-friendly slugged name of the media group.
          • objectType object
            The type object this media group pertains to. Object values found in this array will be an exact match to what can be found in the master list of objectTypes in the common endpoint (/api/v2/common/lookups).
            • objectTypeName string
              The name of the object type.
            • objectTypeNameSlug string
              URL-friendly name of the object type.
          • mediaType string
            The type of media returned.
          • sortOrder int
            The suggested sort order to be used for this media item.
          • links array
            A list HATEOAS for this media item that is a link to view the media in its original size.
            • rel string
              The rel attribute specifies the relationship between the current document and the linked document.
            • href string
              URI of the beefapi call to get more information for this links' context.
            • title string
              Title of the link.
      • links array
        A list of HATEOAS in relation to this beef cut. Typically if this beef cut is online, you will be provided with a link to the endpoint to get the full beef cut details. You will also be provided a link to get all the recipes that use this beef cut.
        • rel string
          The rel attribute specifies the relationship between the current document and the linked document.
        • href string
          URI of the beefapi call to get more information for this links' context.
        • title string
          Title of the link.