Biostacks Biostacks Our public schema for importing and exporting supplements and stacks. Use it to integrate Biostacks with AI assistants, spreadsheets, or any tool that reads JSON.
Simply refer your AI assistant to this page.
The canonical schema is hosted at https://biostacks.app/schema.json . It follows JSON Schema draft-07.
A valid Biostacks export has the following top-level fields:
supplements.items Supplement[] required Supplement library entries.
stacks.items Stack[] required One per schedule (e.g. 08:00 daily, 21:00 daily).
stacks.entries StackItem[] required Which supplement sits in which stack, at what dose.
intake_logs.items IntakeLog[] Historical intake records.
{
"supplements": {
"items": [
{
"id": "supp_xyz789",
"name": "Vitamin D3",
"brand": "Thorne",
"barcode": "693749010105",
"nutrients": [
{ "nutrient": "Vitamin D", "amount": 5000, "unit": "IU" }
],
"createdAt": "2026-01-01T09:00:00.000Z"
}
]
},
"stacks": {
"items": [
{
"id": "08:00|daily",
"schedule": { "time": "08:00", "frequency": "daily" },
"label": "Morning Essentials",
"enabled": true
}
],
"entries": [
{
"id": "entry_abc123",
"supplementId": "supp_xyz789",
"stackId": "08:00|daily",
"dose": 5000,
"unit": "IU",
"source": "manual",
"createdAt": "2026-01-01T09:00:00.000Z"
}
]
},
"intake_logs": {
"items": [
{
"supplementId": "supp_xyz789",
"stackId": "08:00|daily",
"date": "2026-04-18",
"time": "08:00",
"status": "taken",
"loggedAt": "2026-04-18T08:01:03.000Z"
}
]
}
}