openapi: 3.2.0
info:
  description: Swagger documentation supporting mobile development of Crunchtime.
  version: '2.99'
  title: Inventory & Labor Nutrition Service API
  termsOfService: http://springfox.io
  contact:
    name: Crunchtime Development Team
    url: http://www.crunchtime.com
    email: apiquestions@crunchtime.com
  license:
    name: Apache License Version 2.0
    url: https://github.com/springfox/springfox/blob/master/LICENSE
servers:
- url: //webservices-test.net-chef.com
tags:
- name: Nutrition Service
  description: The Nutrition Service is used to create and retrieve data for Nutrition Product records.
paths:
  /nutrition/v1/getAllNutritions:
    get:
      tags:
      - Nutrition Service
      summary: getAllNutritions
      description: Retrieve a list of all Nutrition Details.
      operationId: getAllNutritionV1UsingGET
      parameters:
      - name: activeFlag
        in: query
        description: Fetch all active Nutrition Details
        required: false
        schema:
          type: boolean
      - name: authenticationtoken
        in: header
        description: Secure token for API authentication.
        required: true
        schema:
          type: string
      - name: includeNull
        in: query
        description: Specify 'true' to output null data elements.
        required: false
        allowEmptyValue: true
        schema:
          type: boolean
      - name: includeUsda
        in: query
        description: Fetch either USDA or Custom Nutrition Details
        required: false
        schema:
          type: boolean
      - name: itemDescription
        in: query
        description: This is the Item Description of the Nutrition. Use 2 or more characters.
        required: false
        schema:
          type: string
      - name: itemNumber
        in: query
        description: 'This is the Item Number of the Nutrition '
        required: false
        schema:
          type: string
      - name: minutesSinceUpdate
        in: query
        description: The number of minutes since a Nutrition record was last updated. Use to set how far back to search.
        required: false
        schema:
          type: integer
          format: int32
      - name: password
        in: header
        description: Password for the Crunchtime Application User.
        required: true
        schema:
          type: string
      - name: sitename
        in: header
        description: Crunchtime site identifier. (test or production)
        required: true
        schema:
          type: string
      - name: userid
        in: header
        description: User ID for the Crunchtime Application User
        required: true
        schema:
          type: string
      - name: X-B3-TraceId
        in: header
        description: Optional trace identifier for troubleshooting.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NutritionDetailsList'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NutritionDetailsList'
        '400':
          description: Validation Error
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ObjectError'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ObjectError'
        '401':
          description: Authorization
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '404':
          description: Nutrition not found
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '500':
          description: Unexpected Error
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '504':
          description: Timeout
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
  /nutrition/v1/getNutritionsByPage:
    get:
      tags:
      - Nutrition Service
      summary: getNutritionsByPage
      description: Retrieve a list of Nutrition Details across multiple pages.
      operationId: getNutritionByPageV1UsingGET
      parameters:
      - name: activeFlag
        in: query
        description: Fetch all active Nutrition Details
        required: false
        schema:
          type: boolean
      - name: authenticationtoken
        in: header
        description: Secure token for API authentication.
        required: true
        schema:
          type: string
      - name: includeNull
        in: query
        description: Specify 'true' to output null data elements.
        required: false
        allowEmptyValue: true
        schema:
          type: boolean
      - name: includeUsda
        in: query
        description: Fetch either USDA or Custom Nutrition Details
        required: false
        schema:
          type: boolean
      - name: itemDescription
        in: query
        description: This is the Item Description of the Nutrition. Use 2 or more characters.
        required: false
        schema:
          type: string
      - name: itemNumber
        in: query
        description: 'This is the Item Number of the Nutrition '
        required: false
        schema:
          type: string
      - name: minutesSinceUpdate
        in: query
        description: The number of minutes since a Nutrition record was last updated. Use to set how far back to search.
        required: false
        schema:
          type: integer
          format: int32
      - name: pageNumber
        in: query
        description: pageNumber
        required: false
        schema:
          type: integer
          format: int32
          default: 1
      - name: pageSize
        in: query
        description: pageSize
        required: false
        schema:
          type: integer
          format: int32
      - name: password
        in: header
        description: Password for the Crunchtime Application User.
        required: true
        schema:
          type: string
      - name: sitename
        in: header
        description: Crunchtime site identifier. (test or production)
        required: true
        schema:
          type: string
      - name: userid
        in: header
        description: User ID for the Crunchtime Application User
        required: true
        schema:
          type: string
      - name: X-B3-TraceId
        in: header
        description: Optional trace identifier for troubleshooting.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/NutritionBatchResponseDto'
            application/json:
              schema:
                $ref: '#/components/schemas/NutritionBatchResponseDto'
        '400':
          description: Validation Error
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ObjectError'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ObjectError'
        '401':
          description: Authorization
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '404':
          description: Nutrition not found
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '500':
          description: Unexpected Error
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '504':
          description: Timeout
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
  /nutrition/v1/saveNutritions:
    post:
      tags:
      - Nutrition Service
      summary: saveNutritions
      description: Create or Update Nutrition records
      operationId: saveNutritionUsingPOST
      parameters:
      - name: authenticationtoken
        in: header
        description: Secure token for API authentication.
        required: true
        schema:
          type: string
      - name: password
        in: header
        description: Password for the Crunchtime Application User.
        required: true
        schema:
          type: string
      - name: sitename
        in: header
        description: Crunchtime site identifier. (test or production)
        required: true
        schema:
          type: string
      - name: userid
        in: header
        description: User ID for the Crunchtime Application User
        required: true
        schema:
          type: string
      - name: X-B3-TraceId
        in: header
        description: Optional trace identifier for troubleshooting.
        required: false
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NutritionDetailsList'
        description: nutritionDetails
        required: true
      responses:
        '200':
          description: Success
          content:
            '*/*':
              schema:
                type: object
            application/json:
              schema:
                type: object
        '400':
          description: Validation Error
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ObjectError'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ObjectError'
        '401':
          description: Authorization
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '500':
          description: Unexpected Error
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
        '504':
          description: Timeout
          content:
            '*/*':
              schema:
                type: string
            application/json:
              schema:
                type: string
components:
  schemas:
    NutritionBatchResponseDto:
      type: object
      properties:
        hasNext:
          type: boolean
        nutritionDetails:
          type: array
          items:
            $ref: '#/components/schemas/NutritionDetails'
        totalPages:
          type: integer
          format: int32
      title: NutritionBatchResponseDto
      description: NutritionBatchResponseDto description
    NutritionDetails:
      type: object
      properties:
        nutritionDetailDetails:
          type: array
          items:
            $ref: '#/components/schemas/NutritionDetailsDto'
      title: NutritionDetails
      description: NutritionDetails description
    ObjectError:
      type: object
      properties:
        arguments:
          type: array
          items:
            type: object
        code:
          type: string
        codes:
          type: array
          items:
            type: string
        defaultMessage:
          type: string
        objectName:
          type: string
      title: ObjectError
    NutritionDetailsList:
      type: object
      properties:
        locationCode:
          type: string
          example: '000000'
          description: Location "Code" from Nutrition screen
        nutritionDetails:
          type: array
          items:
            $ref: '#/components/schemas/NutritionDetails'
      title: NutritionDetailsList
      description: NutritionDetailsList description
    NutritionDetailsDto:
      type: object
      required:
      - addedSugars
      - calcium
      - calories
      - cholesterol
      - dietaryFiber
      - iron
      - itemDescription
      - itemNumber
      - potassium
      - protein
      - saturatedFat
      - sodium
      - sugars
      - totalCarbohydrate
      - totalFat
      - transFat
      - vitaminA
      - vitaminC
      - vitaminD
      properties:
        active:
          type: string
        addedSugars:
          type: number
          example: 15
          description: '"Added Sugars g per 100g" from Nutrition screen.'
        calcium:
          type: number
          example: 15
          description: '"Calcium mg per 100g" from Nutrition screen.'
        calories:
          type: number
          example: 15
          description: '"Calories kCal per 100g" from Nutrition screen.'
        cholesterol:
          type: number
          example: 15
          description: '"Cholesterol mg per 100g" from Nutrition screen.'
        dietaryFiber:
          type: number
          example: 15
          description: '"Dietary Fiber g per 100g" from Nutrition screen.'
        iron:
          type: number
          example: 15
          description: '"Iron mg per 100g" from Nutrition screen.'
        itemDescription:
          type: string
          example: NUTRITION-TEST
          description: '"Item Description" from Nutrition screen.'
        itemNumber:
          type: string
          example: 123456
          description: '"Item Number" from Nutrition screen.'
        potassium:
          type: number
          example: 15
          description: '"Potassium mg per 100g" from Nutrition screen.'
        protein:
          type: number
          example: 15
          description: '"Protein g per 100g" from Nutrition screen.'
        saturatedFat:
          type: number
          example: 15
          description: '"Saturated Fat g per 100g" from Nutrition screen.'
        sodium:
          type: number
          example: 15
          description: '"Sodium mg per 100g" from Nutrition screen.'
        sugars:
          type: number
          example: 15
          description: '"Sugars g per 100g" from Nutrition screen.'
        totalCarbohydrate:
          type: number
          example: 15
          description: '"Total Carbohydrates g per 100g" from Nutrition screen.'
        totalFat:
          type: number
          example: 15
          description: '"Total Fat g per 100g" from Nutrition screen.'
        transFat:
          type: number
          example: 15
          description: '"Trans Fat g per 100g" from Nutrition screen.'
        usda:
          type: string
        vitaminA:
          type: number
          example: 15
          description: '"Vitamin A IU per 100g" from Nutrition screen.'
        vitaminC:
          type: number
          example: 15
          description: '"Vitamin C mg per 100g" from Nutrition screen'
        vitaminD:
          type: number
          example: 15
          description: '"Vitamin D IU per 100g" from Nutrition screen.'
      title: NutritionDetailsDto
      description: NutritionDetailsDto description
externalDocs:
  description: Crunchtime Developer Hub
  url: https://developer.crunchtime.com/
x-provenance:
  method: searched
  source: https://developer.crunchtime.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developer.crunchtime.com/reference/downloadscheduledexportsv1usingget.md
  - https://developer.crunchtime.com/reference/downloadscheduledexportsv2usingget.md
  - https://developer.crunchtime.com/reference/get15minutessalesforecastbypagev1usingget.md
  - https://developer.crunchtime.com/reference/get15minutessalesforecastv1usingget.md
  - https://developer.crunchtime.com/reference/get_commissaryorder-v1-getcommissaryordersbypage.md
  - https://developer.crunchtime.com/reference/get_customerorderenhanced-v1-getcustomerorderenhancedbypage.md
  - https://developer.crunchtime.com/reference/getallapplicationusersv1usingget.md
  - https://developer.crunchtime.com/reference/getallbudgetv1usingget.md
  - https://developer.crunchtime.com/reference/getallcategoryv1usingget.md
  - https://developer.crunchtime.com/reference/getallcheckmenumixrecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getallcommissaryordersv1usingget.md
  - https://developer.crunchtime.com/reference/getallcompanyproductsenhancedv1usingget.md
  - https://developer.crunchtime.com/reference/getallconfirmreceiptstandardv1usingget.md
  - https://developer.crunchtime.com/reference/getallcurrencyratiov1usingget.md
  - https://developer.crunchtime.com/reference/getallcustomerorderenhancedv1usingget.md
  - https://developer.crunchtime.com/reference/getallcustomerrecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getalldailyprepsv1usingget.md
  - https://developer.crunchtime.com/reference/getallgeneralledgersv1usingget.md
  - https://developer.crunchtime.com/reference/getallinventoryadjustmentv1usingget.md
  - https://developer.crunchtime.com/reference/getallinventorylocationtransfersv1usingget.md
  - https://developer.crunchtime.com/reference/getallinventoryvalueadjustmentv1usingget.md
  - https://developer.crunchtime.com/reference/getalllocationproductpricingv1usingget.md
  - https://developer.crunchtime.com/reference/getalllocationsv1usingget.md
  - https://developer.crunchtime.com/reference/getallnutritionv1usingget.md
  - https://developer.crunchtime.com/reference/getallpackagetypesv2usingget.md
  - https://developer.crunchtime.com/reference/getallpbisbypagev2usingget.md
  - https://developer.crunchtime.com/reference/getallpbisv2usingget.md
  - https://developer.crunchtime.com/reference/getallphysicalinventorystandardusingget.md
  - https://developer.crunchtime.com/reference/getallprojectedconsumptionv1usingget.md
  - https://developer.crunchtime.com/reference/getallpurchaseordersv1usingget.md
  - https://developer.crunchtime.com/reference/getallrecipelocationv1usingget.md
  - https://developer.crunchtime.com/reference/getallrecipesenhancedv2usingget.md
  - https://developer.crunchtime.com/reference/getallsalesmixrecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getallscheduledexportsv1usingget.md
  - https://developer.crunchtime.com/reference/getallstoragelocationv1usingget.md
  - https://developer.crunchtime.com/reference/getallsupplementalwagerecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getalltimeclockenhancedrecordsv1usingget.md
  - https://developer.crunchtime.com/reference/getallvendorlocationv1usingget.md
  - https://developer.crunchtime.com/reference/getallvendorpaymentv1usingget.md
  - https://developer.crunchtime.com/reference/getallvendorproductpricingv1usingget.md
  - https://developer.crunchtime.com/reference/getallvendorsv1usingget.md
  - https://developer.crunchtime.com/reference/getapplicationusersbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getattachmentsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getattachmentsbypagev2.md
  - https://developer.crunchtime.com/reference/getbudgetbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcategorybypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcheckmenumixrecordsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcompanyproductsenhancedbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getconfirmreceiptstandardbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcurrencyratiobypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcurrentinventorybypagev1usingget.md
  - https://developer.crunchtime.com/reference/getcustomerrecordsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getdailyprepsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getdailysalesforecastbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getdailysalesforecastv1usingget.md
  - https://developer.crunchtime.com/reference/getemployeenumbersv1usingget.md
  - https://developer.crunchtime.com/reference/getemployeesbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getemployeev1usingget.md
  - https://developer.crunchtime.com/reference/gethierarchiesv2usingget.md
  - https://developer.crunchtime.com/reference/gethierarchydetailsv2usingget.md
  - https://developer.crunchtime.com/reference/gethourlysalesforecastbypagev1usingget.md
  - https://developer.crunchtime.com/reference/gethourlysalesforecastv1usingget.md
  - https://developer.crunchtime.com/reference/getinventoryadjustmentbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getinventorylocationtransfersbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getinventoryvalueadjustmentbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getlocationproductpricingbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getlocationsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getnutritionbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getpackagetypesbypagev2usingget.md
  - https://developer.crunchtime.com/reference/getphysicalinventorystandardbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getprojectedconsumptionbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getpurchaseordersbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getrecipelocationbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getrecipesenhancedbypagev2usingget.md
  - https://developer.crunchtime.com/reference/getsalesmixrecordsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getschedulesv1usingget.md
  - https://developer.crunchtime.com/reference/getstoragelocationbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getsupplementalwagerecordsbypageusingget.md
  - https://developer.crunchtime.com/reference/gettimeclockenhancedrecordsbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getudalocationsusingget.md
  - https://developer.crunchtime.com/reference/getudavendorsusingget.md
  - https://developer.crunchtime.com/reference/getvendorlocationbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getvendorpaymentbypagev1usingget.md
  - https://developer.crunchtime.com/reference/getvendorproductpricingbypagev1usingget.md
  - https://developer.crunchtime.com/reference/markscheduledexportsv1usingput.md
  - https://developer.crunchtime.com/reference/save15minutessalesforecastusingpost.md
  - https://developer.crunchtime.com/reference/saveapplicationusersv1usingpost.md
  - https://developer.crunchtime.com/reference/savebudgetusingpost.md
  - https://developer.crunchtime.com/reference/savecategoryusingpost.md
  - https://developer.crunchtime.com/reference/savecheckmenumixrecordsv1usingpost.md
  - https://developer.crunchtime.com/reference/savecompanyproductenhancedv1usingpost.md
  - https://developer.crunchtime.com/reference/saveconfirmreceiptstandardusingpost.md
  - https://developer.crunchtime.com/reference/savecurrencyratiousingpost.md
  - https://developer.crunchtime.com/reference/savecustomerorderenhancedusingpost.md
  - https://developer.crunchtime.com/reference/savecustomerrecordsusingpost.md
  - https://developer.crunchtime.com/reference/savedailyprepsusingpost.md
  - https://developer.crunchtime.com/reference/savedailysalesforecastusingpost.md
  - https://developer.crunchtime.com/reference/saveelectronicinvoiceusingpost.md
  - https://developer.crunchtime.com/reference/saveemployeev1usingpost.md
  - https://developer.crunchtime.com/reference/savegeneralledgerv1usingpost.md
  - https://developer.crunchtime.com/reference/savehierarchyv2usingpost.md
  - https://developer.crunchtime.com/reference/savehourlysalesforecastusingpost.md
  - https://developer.crunchtime.com/reference/saveinventoryadjustmentusingpost.md
  - https://developer.crunchtime.com/reference/saveinventoryvalueadjustmentusingpost.md
  - https://developer.crunchtime.com/reference/savelocationproductpricingusingpost.md
  - https://developer.crunchtime.com/reference/savelocationv1usingpost.md
  - https://developer.crunchtime.com/reference/savenutritionusingpost.md
  - https://developer.crunchtime.com/reference/savepackagetypesv2usingpost.md
  - https://developer.crunchtime.com/reference/savepbiv2usingpost.md
  - https://developer.crunchtime.com/reference/savephysicalinventorystandardusingpost.md
  - https://developer.crunchtime.com/reference/saveprojectedconsumptionusingpost.md
  - https://developer.crunchtime.com/reference/savepurchaseordersusingpost.md
  - https://developer.crunchtime.com/reference/saverecipelocationusingpost.md
  - https://developer.crunchtime.com/reference/saverecipesv2usingpost.md
  - https://developer.crunchtime.com/reference/savesalesmixrecordusingpost.md
  - https://developer.crunchtime.com/reference/savestoragelocationusingpost.md
  - https://developer.crunchtime.com/reference/savesupplementalwagerecordsusingpost.md
  - https://developer.crunchtime.com/reference/savetimeclockenhancedrecordsusingpost.md
  - https://developer.crunchtime.com/reference/savevendorlocationv1usingpost.md
  - https://developer.crunchtime.com/reference/savevendorpaymentusingpost.md
  - https://developer.crunchtime.com/reference/savevendorv1usingpost.md
  - https://developer.crunchtime.com/reference/validateuserusingpost.md
  merge:
    pages: 122
    deduped: 334
    conflicts_kept_first: 0