Introduction
Quick Start
Make your first API request in under a minute.
Prerequisites
- A Home Plate account with a Premium subscription
- An API key (generate from your profile)
Fetch your current meal plan
Make the request
curl -H "X-API-Key: hp_your_key_here" \
https://www.homeplatemeal.com/api/meal-plans/v1/current
Review the response
{
"data": {
"id": "abc123",
"weekOf": "2026-03-23T00:00:00.000Z",
"meals": {
"Monday": {
"breakfast": {
"description": "Greek yogurt parfait with granola and berries"
},
"lunch": {
"description": "Turkey and avocado wrap",
"recipeId": "recipe_456"
},
"dinner": {
"description": "Lemon herb grilled chicken with roasted vegetables",
"recipeId": "recipe_789"
}
},
"Tuesday": {
"breakfast": {
"description": "Overnight oats with banana"
}
}
}
}
}
Use the data
The response includes your meal plan organized by day, with each meal's description and optional recipe ID. The consolidated shopping list contains all ingredients from every recipe in the plan.
Try it live
Paste your API key below to make a real request right from the docs.
GET
/api/meal-plans/v1/currentcURL
curl -H "X-API-Key: hp_your_key_here" \
https://www.homeplatemeal.com/api/meal-plans/v1/currentUsing other languages
const response = await fetch(
'https://www.homeplatemeal.com/api/meal-plans/v1/current',
{
headers: { 'X-API-Key': process.env.HOMEPLATE_API_KEY }
}
)
const { data } = await response.json()
console.log(data.meals.Monday.dinner.description)
import requests
import os
response = requests.get(
'https://www.homeplatemeal.com/api/meal-plans/v1/current',
headers={'X-API-Key': os.environ['HOMEPLATE_API_KEY']}
)
data = response.json()['data']
print(data['meals']['Monday']['dinner']['description'])