> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbbit.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Branded Food

> One packaged food — every field USDA publishes for it.

Requires the `get-branded-foods` scope.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/branded-foods/{id}
openapi: 3.1.0
info:
  title: Orbbit Data API
  version: '1.0'
  description: >-
    Commodity prices, packaged-food labels, and online store catalogs over one
    read-only REST API.
servers:
  - url: https://api.orbbit.co
    description: Production
security:
  - bearer: []
tags:
  - name: Commodities
  - name: Branded Food
  - name: Shopify
paths:
  /v1/branded-foods/{id}:
    get:
      tags:
        - Branded Food
      summary: Get a Branded Food
      description: |-
        One packaged food — every field USDA publishes for it.

        Requires the `get-branded-foods` scope.
      operationId: BrandedFoodsController_getOne
      parameters:
        - name: id
          required: true
          in: path
          description: A product id from a search result
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBrandedFoodResponseDto'
              example:
                data:
                  id: data_branded_food_01k2x7f3m9q8r4t6v0w2y5z8ab
                  fdc_id: 2345678
                  description: SHARP CHEDDAR CHEESE
                  short_description: null
                  brand_owner: Kraft Heinz Foods Company
                  brand_name: CRACKER BARREL
                  subbrand_name: null
                  category: Cheese
                  gpc_class_code: 10000013
                  upc: '021000601366'
                  package_weight: 7 oz/198 g
                  serving_size: 28
                  serving_size_unit: GRM
                  serving_size_unit_normalized: g
                  household_serving_text: 1 oz
                  preparation_state_code: null
                  market_country: United States
                  market_country_normalized: US
                  trade_channels:
                    - NO_TRADE_CHANNEL
                  ingredients: >-
                    CHEDDAR CHEESE (PASTEURIZED MILK, CHEESE CULTURE, SALT,
                    ENZYMES, ANNATTO (COLOR)).
                  nutrition:
                    calories: 110
                    fat: 9
                    saturated_fat: 6
                    trans_fat: 0
                    cholesterol: 30
                    sodium: 180
                    carbohydrates: 0
                    fiber: 0
                    sugars: 0
                    added_sugar: 0
                    protein: 7
                    calcium: 200
                    iron: 0
                    potassium: 20
                    vitamin_d: 0
                  nutrients: []
                  attributes: []
                  caffeine_statement: null
                  footnote: null
                  data_source: GDSN
                  published_on: '2024-10-31'
                  available_on: '2024-10-31'
                  modified_on: '2024-09-12'
                  discontinued_on: null
                  source: usda-fdc
                  fetched_at: '2026-08-23T03:29:33.000Z'
        '401':
          description: The API key is missing, malformed, unknown, or revoked
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiErrorDto'
              example:
                error:
                  type: unauthorized
                  message: 'Missing or malformed Authorization: Bearer header'
        '403':
          description: The key is valid but not scoped to this endpoint
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiErrorDto'
              example:
                error:
                  type: forbidden
                  message: This key is not scoped to get-branded-foods
        '404':
          description: No record has this ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiErrorDto'
              example:
                error:
                  type: not_found
                  message: >-
                    Unknown branded food:
                    data_branded_food_01k0000000000000000000000
      security:
        - bearer: []
components:
  schemas:
    GetBrandedFoodResponseDto:
      type: object
      properties:
        data:
          type: object
          properties:
            id:
              type: string
            fdc_id:
              type: number
            description:
              type: string
            short_description:
              anyOf:
                - type: string
                - type: 'null'
            brand_owner:
              anyOf:
                - type: string
                - type: 'null'
            brand_name:
              anyOf:
                - type: string
                - type: 'null'
            subbrand_name:
              anyOf:
                - type: string
                - type: 'null'
            category:
              anyOf:
                - type: string
                - type: 'null'
            gpc_class_code:
              anyOf:
                - type: number
                - type: 'null'
            upc:
              anyOf:
                - type: string
                - type: 'null'
            package_weight:
              anyOf:
                - type: string
                - type: 'null'
            serving_size:
              anyOf:
                - type: number
                - type: 'null'
            serving_size_unit:
              anyOf:
                - type: string
                - type: 'null'
            serving_size_unit_normalized:
              anyOf:
                - type: string
                - type: 'null'
            household_serving_text:
              anyOf:
                - type: string
                - type: 'null'
            preparation_state_code:
              anyOf:
                - type: string
                - type: 'null'
            market_country:
              anyOf:
                - type: string
                - type: 'null'
            market_country_normalized:
              anyOf:
                - type: string
                - type: 'null'
            trade_channels:
              anyOf:
                - type: array
                  items: {}
                - type: 'null'
            ingredients:
              anyOf:
                - type: string
                - type: 'null'
            nutrition:
              type: object
              properties:
                calories:
                  anyOf:
                    - type: number
                    - type: 'null'
                fat:
                  anyOf:
                    - type: number
                    - type: 'null'
                saturated_fat:
                  anyOf:
                    - type: number
                    - type: 'null'
                trans_fat:
                  anyOf:
                    - type: number
                    - type: 'null'
                cholesterol:
                  anyOf:
                    - type: number
                    - type: 'null'
                sodium:
                  anyOf:
                    - type: number
                    - type: 'null'
                carbohydrates:
                  anyOf:
                    - type: number
                    - type: 'null'
                fiber:
                  anyOf:
                    - type: number
                    - type: 'null'
                sugars:
                  anyOf:
                    - type: number
                    - type: 'null'
                added_sugar:
                  anyOf:
                    - type: number
                    - type: 'null'
                protein:
                  anyOf:
                    - type: number
                    - type: 'null'
                calcium:
                  anyOf:
                    - type: number
                    - type: 'null'
                iron:
                  anyOf:
                    - type: number
                    - type: 'null'
                potassium:
                  anyOf:
                    - type: number
                    - type: 'null'
                vitamin_d:
                  anyOf:
                    - type: number
                    - type: 'null'
              required:
                - calories
                - fat
                - saturated_fat
                - trans_fat
                - cholesterol
                - sodium
                - carbohydrates
                - fiber
                - sugars
                - added_sugar
                - protein
                - calcium
                - iron
                - potassium
                - vitamin_d
            nutrients:
              anyOf:
                - type: array
                  items: {}
                - type: 'null'
            attributes:
              anyOf:
                - type: array
                  items: {}
                - type: 'null'
            caffeine_statement:
              anyOf:
                - type: string
                - type: 'null'
            footnote:
              anyOf:
                - type: string
                - type: 'null'
            data_source:
              anyOf:
                - type: string
                - type: 'null'
            published_on:
              anyOf:
                - type: string
                - type: 'null'
            available_on:
              anyOf:
                - type: string
                - type: 'null'
            modified_on:
              anyOf:
                - type: string
                - type: 'null'
            discontinued_on:
              anyOf:
                - type: string
                - type: 'null'
            source:
              type: string
            fetched_at:
              anyOf:
                - type: string
                - type: 'null'
          required:
            - id
            - fdc_id
            - description
            - short_description
            - brand_owner
            - brand_name
            - subbrand_name
            - category
            - gpc_class_code
            - upc
            - package_weight
            - serving_size
            - serving_size_unit
            - serving_size_unit_normalized
            - household_serving_text
            - preparation_state_code
            - market_country
            - market_country_normalized
            - trade_channels
            - ingredients
            - nutrition
            - nutrients
            - attributes
            - caffeine_statement
            - footnote
            - data_source
            - published_on
            - available_on
            - modified_on
            - discontinued_on
            - source
            - fetched_at
      required:
        - data
    PublicApiErrorDto:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
            message:
              type: string
          required:
            - type
            - message
      required:
        - error
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: Your API key, which starts with `orbbit_data_`.

````