Beef API - Cattlemen's Beef Board and National Cattlemen's Beef Association

GET Beef Cut

Two similar endpoints can be used to fetch all the information about a single beef cut. The endpoints differ by one parameter: one accepts a beef cut ingredient ID, while the other accepts a beef cut's slugged name.

The base URIs for the "Get Beef Cut By ID" and "Get Beef Cut By Name" are:

GET /api/v2/beefcut/{id}
GET /api/v2/beefcut/{name}

Get Beef Cut By ID Parameters

Try This Endpoint on Swagger

Name	Required	Parameter Type	Data Type
id		path	integer
	A valid beef cut ingredient ID

Get Beef Cut By Name Parameters

Try This Endpoint on Swagger

Name	Required	Parameter Type	Data Type
name		path	string
	Unique slugged name of the beef cut

Both endpoints also accept the following parameters either in the query string or the request header.

Name	Required	Parameter Type	Data Type
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 Cut By ID" and "Get Beef Cut By Name" API will return the following data:

Name & Description	Type

IngredientFull object
A container that holds the resulting beef cut information
- 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
- marketingText string
  Marketing text of the beef cut
- preparationText string
  Helpful preparation information for the beef cut
- orderingText string
  Information that will help when ordering the beef cut from a butcher
- cutDescriptionText string
  A more scientific description of the beef cut
- butchersTip string
  Tips that a butcher may provide about 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
- upcNumber string
  The Universal Product Code(UPC) of the beef cut. This information would appear on an on-pack beef label
- urmisName string
  The Uniform Retail Meat Identity Standards(URMIS) name for the beef cut. This information would appear on an on-pack beef label
- urmisCutCharacteristics string
  Helpful cut characteristics of a beef cut. This information would appear on an on-pack beef label.
- urmisPreparationTip string
  Used to tell a consumer the best preparation methods or other helpful information. This information would appear on an on-pack beef label
- nampNumber string
  NAMP (National Association of Meat Purveyors) number. Used to standardize meat cutting for the foodservice industry
- nampName string
  NAMP (National Association of Meat Purveyors) name that corresponds with the nampNumber field.
- 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
- 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
- aliases array
  A list of other common or regional names that the given beef cut may also be called
  - aliasName string
    Another name for the beef cut
  - aliasNameSlug string
    URL-friendly slugged name of the current alias
- allergens array
  A list of any allergens that this beef cut may contain. Object values found in this array will be an exact match to what can be found in the master list of allergens in the common endpoint (/api/v2/common/lookups)
  - allergenName string
    Name of the allergen
  - allergenNameSlug string
    URL-friendly slugged name of the allergen
- alternatives array
  A list of alternative beef cuts that is suggested for the given beef cut
  - alternativeText string
    Any corresponding text that may accompany this alternative beef cut
  - ingredientID int
    The alternative beef cut ingredient ID
  - ingredientName string
    The name of this alternative beef cut
  - ingredientNameSlug string
    URL-friendly slugged name of this alternative beef cut
  - isOnline boolean
    Marker to denote if this beef cut is available on the Beef API
  - links array
    A list of HATEOAS in relation to this collection. Typically if this collection is online, you will be provided with a link to the endpoint to get the full collection details.
    - rel string
      A list of HATEOAS in relation to this alternative 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.
    - href string
      URI of the beefapi call to get more information for this links' context
    - title string
      Title of the link
- 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
- collections array
  A list of collections to which the beef cut belongs. Object values found in this array will be an exact match to what can be found in the master list of collections in the common endpoint (/api/v2/common/lookups)
  - collectionID int
    Unique identifier for the collection
  - collectionName string
    Unique name of the collection
  - collectionNameSlug string
    URL-friendly name of the collection
  - collectionGroup object
    Contains information about the group to which the collection belongs. Object values found in this array will be an exact match to what can be found in the master list of collection groups in the common endpoint (/api/v2/common/lookups)
    - collectionGroupName string
      Name of the collection group
    - collectionGroupNameSlug string
      URL-friendly name of the collection group
    - objectType object
      The type object this collection 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 this collection group pertains to
      - objectTypeNameSlug string
        URL-friendly slugged name of the object type this collection group pertains to
  - objectType object
    The type object this collection 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 this collection pertains to
    - objectTypeNameSlug string
      URL-friendly slugged name of the object type this collection pertains to
  - links array
    A list of HATEOAS in relation to this collection. Typically if this collection is online, you will be provided with a link to the endpoint to get the full collection details.
    - 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
- groups array
  A list of ingredient groups that this beef cut may belong to. Ingredient groups are used to manage ingredients that are considered synonyms. When retrieving a list of recipes, typically all the recipes will be returned for all the ingredients in a group. An example group would be "Ground Beef", and it would include all the beef cuts ("83% Ground Beef, 95% Ground Beef, etc"). Object values found in this array will be an exact match to what can be found in the master list of ingredientGroups in the common endpoint (/api/v2/common/lookups)
  - ingredientGroupName string
    The name of the ingredient group
  - ingredientGroupNameSlug string
    URL-friendly slugged name of the ingredient group
- nutritionals array
  A list of nutritional information objects that pertain to this beef cut
  - nutritionalType string
    The type of nutritional. This will be "raw" or "cooked"
  - ndB_No string
    The unique identifier found in the USDA nutrient database that this nutritional object represents
  - usdaFoodName string
    The food name for the beef cut found in the USDA nutrient database
  - servingSizeText string
    The serving size used to calculate the nutritional information
  - cookedTipText string
    Information about how the nutritional information was calculated
  - insignificantText string
    Information about any insignificant nutrients for the beef cut that are not large enough to have a nutritional impact in the calculated nutritionals.
  - dvDietBasisText string
    Information about the amount of calories used to calculate the daily value percentages
  - calorieDietBasisText string
    Information about the amount of calories used for the daily value calculation for calories
  - source string
    USDA release version of the data being reported
  - isPrimary boolean
    Used to determine if this is the primary nutritional record from the list
  - nutritionalText string
    Describes the nutritional, including the official nutritional description and an ordered list of nutrients and quantities
  - nutritionTip string
    Defines which nutrients in the beef cut fall within the good & excellent value thresholds
- pairings array
  A list of ingredients that may go well with the given beef cut
  - pairingText string
    Any corresponding text that may accompany this ingredient pairing
  - ingredientID int
    Unique identifier of the paired ingredient
  - ingredientName string
    Name of the paired ingredient
  - ingredientNameSlug string
    URL-friendly slugged name of the paired ingredient
  - isOnline boolean
    Marker to denote if this paired ingredient is available on the Beef API
  - links array
    A list of HATEOAS in relation to this collection. Typically if this collection is online, you will be provided with a link to the endpoint to get the full collection details.
    - rel string
      A list of HATEOAS in relation to this paired ingredient. Typically if this paired ingredient is online, you will be provided with a link to the endpoint to get the full paired ingredient details. You will also be provided a link to get all the recipes that use this paired ingredient.
    - href string
      URI of the beefapi call to get more information for this links' context
    - title string
      Title of the link
- rollups array
  A list of beef cuts that this beef cut rolls up to. Ingredient rollups are used when one ingredient rolls into another ingredient. Typically this scenario is one ingredient rolls into a generic ingredient. Such as beef for kabobs, beef for stew, beef for stir fry etc.
  - rollupText string
    Any corresponding text that may accompany this rollup
  - ingredientID int
    The rollup beef cut ingredient ID
  - ingredientName string
    The name of this rollup ingredient
  - ingredientNameSlug string
    URL-friendly slugged name of this rollup ingredient
  - isOnline boolean
    Marker to denote if this rollup ingredient is available on the Beef API
  - links array
    A list of HATEOAS in relation to this collection. Typically if this collection is online, you will be provided with a link to the endpoint to get the full collection details.
    - rel string
      A list of HATEOAS in relation to this rollup. Typically if this rollup beef cut is online, you will be provided with a link to the endpoint to get the full rollup ingredient details. You will also be provided a link to get all the recipes that use this rollup ingredient.
    - href string
      URI of the beefapi call to get more information for this links' context
    - title string
      Title of the link
- menuApplications array
  A list of suggested Menu Applications that this beef cut could be marketed for
  - subheading string
    Used to group uses together in a list.
  - menuApplicationText string
    Text of the use.
  - sortOrder int
    The sort order that this use should be displayed.
  - media array
    A list of media objects containing information about media assigned to this menu application record
    - 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
- substitutes array
  A list of beef cuts that could used in place of the current beef cut
  - substituteText string
    Any corresponding text that may accompany this substitute beef cut
  - ingredientID int
    The substitute beef cut ingredient ID
  - ingredientName string
    The name of this substitute beef cut
  - ingredientNameSlug string
    URL-friendly slugged name of this substitute beef cut
  - isOnline boolean
    Marker to denote if this beef cut is available on the Beef API
  - links array
    A list of HATEOAS in relation to this substitute 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
      A list of HATEOAS in relation to this alternative 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.
    - href string
      URI of the beefapi call to get more information for this links' context
    - title string
      Title of the link
- ingredientTree array
  A list of beef cuts that are found as parents, children or cousins of this beef cut. This data structure is used to communicate the hierarchy of relationships of this beef cut
  - parentIngredientID int
    The parent beef cut ingredient ID of this beef cut tree record
  - isBeefPrimal boolean
    True if this beef cut tree record is a primal beef cut
  - isBeefSubprimal boolean
    True if this beef cut tree record is a subprimal beef cut
  - isBeefSubsection boolean
    True if this beef cut tree record is a subsection beef cut
  - isBeefFabricatedCut boolean
    True if this beef cut tree record is a fabricated beef cut
  - isLean boolean
    True if this beef cut tree record is a lean beef cut
  - isMarinate boolean
    True if this beef cut tree record beef cut is suggested to marinate
  - ingredientID int
    The beef cut ingredient ID of this beef cut tree record
  - 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
  - media array
    A list of media objects containing information about media assigned to this ingredient record. This data will only be present if a beef cut is online.
    - 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 substitute 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
- parentIngredient object
  Object representing the hierarchical parent beef cut of the current beef cut.
  - ingredientID int
    The beef cut ingredient ID
  - 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
  - links array
    A list of HATEOAS in relation to this substitute 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
- primalIngredient object
  Object representing the current beef cuts primal beef cut ancestor in its hierarchy
  - ingredientID int
    The beef cut ingredient ID
  - 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
  - links array
    A list of HATEOAS in relation to this substitute 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
- cookingGuidelines object
  Object representing cooking methods and times for this beef cut
  - attributeName string
    The cooking attribute name
  - beefThicknessInches int
    Ideal thickness for the beef cut and this cooking method
  - cookingGuidelineID int
    Unique identifier for the cooking guideline
  - cookingRangeStartTimeMinutes int
    Minimum cooking time
  - cookingRangeEndTimeMinutes int
    Maximum cooking time
  - cookingTimeMinutes int
    When a range isn't used, this specifies the cooking time
  - distanceFromHeatInches int
    Distance the beef cut should be from the heat source
  - donenessName string
    Term defining the level of doneness
  - grillingMethodName string
    The specific name of a grilling method
  - ingredientID int
    Unique identifier of the beef cut
  - ingredientName string
    Name of the beef cut
  - internalTemperatureFahrenheit int
    Internal temperature the beef cut should reach
  - ovenTemperatureFahrenheit int
    Temperature the oven should be set to
  - weightInOunces int
    Weight of the beef cut
  - weightRangeStartOunces int
    Minimum weight of the beef cut
  - weightRangeEndOunces int
    Maximum weight of the beef cut
- 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

About the Beef API

Developer Requirements

Common Endpoint

Recipe Endpoints

Beef Cut Endpoints

V1 Documentation

GET Beef Cut

Get Beef Cut By ID Parameters

Get Beef Cut By Name Parameters

What it Returns