Version 1.0.0

Biostacks Data Schema

Public schema for importing and exporting supplements and stacks. Use it to integrate Biostacks with AI assistants, spreadsheets, or any tool that reads JSON.

Share with AI screen in the Biostacks app

Refer your AI assistant to this page or link directly to the schema file.

Download

Top-level fields

All fields on the root export object.

Field Type Required
supplements.items Supplement[] required
stacks.entries StackItem[] required
stacks.items Stack[] required

Schedule

Field Type Required Notes
time string required ^[0-2][0-9]:[0-5][0-9]$
frequency "daily" | "specific" required
weekdays DayOfWeek[]

NutrientEntry

Field Type Required Notes
nutrient string required
amount number required
unit NutrientUnit required

Supplement

Field Type Required Notes
id string required
name string required
brand string
barcode string
source "nih" | "off" | "manual"
imageUrl string
nutrients NutrientEntry[] required
servingSize string
servingSizeUnit ServingUnit
containerSize string
containerSizeUnit ServingUnit
calories number
protein number
fat number
carbs number
fiber number
sugar number
sodium number
createdAt string required ISO 8601

Stack

Field Type Required Notes
id string required
schedule Schedule required
label string
enabled boolean required

StackItem

Field Type Required Notes
id string required
supplementId string required
stackId string required
dose number required
unit ServingUnit required
stackOrder number
createdAt string required ISO 8601

DayOfWeek

Enum: "mon", "tue", "wed", "thu", "fri", "sat", "sun"

NutrientUnit

Enum: "mg", "mcg", "g", "IU", "ml", "fl oz", "tsp", "tbsp", "B CFU", "mcg DFE", "mg DFE", "mg AT", "mg RAE", "mg NE", "ng"

ServingUnit

Enum: "mg", "mcg", "g", "IU", "ml", "fl oz", "tsp", "tbsp", "B CFU", "mcg DFE", "mg DFE", "mg AT", "mg RAE", "mg NE", "ng", "capsule", "tablet", "softgel", "scoop", "drop", "dropperful", "gummy", "disc", "packet", "serving"