Meal Plans
Get Next Week's Meal Plan
Retrieve next week's meal plan for your family.
Request
GET /api/meal-plans/v1/next
Headers
| Header | Required | Description |
|---|---|---|
X-API-Key | Yes | Your Home Plate API key |
Parameters
This endpoint takes no parameters. It returns the meal plan for next week (the Monday after the current week through Sunday).
Response
Success (200)
Returns next week's meal plan, or null if no plan has been generated yet.
{
"data": {
"id": "def456",
"weekOf": "2026-03-30T00:00:00.000Z",
"meals": {
"Monday": {
"breakfast": {
"description": "Smoothie bowl with mixed berries"
},
"lunch": {
"description": "Chicken caesar salad",
"recipeId": "recipe_234"
},
"dinner": {
"description": "Beef stir-fry with vegetables",
"recipeId": "recipe_567"
}
},
"Tuesday": { ... },
"Wednesday": { ... }
}
}
}
When no meal plan exists for next week:
{
"data": null
}
Response fields
| Field | Type | Description |
|---|---|---|
data.id | string | Unique meal plan identifier |
data.weekOf | string | ISO 8601 date for Monday of the plan week |
data.meals | object | Meals organized by day name (Monday–Sunday) |
data.meals.[day].breakfast | object? | Breakfast meal slot |
data.meals.[day].lunch | object? | Lunch meal slot |
data.meals.[day].dinner | object? | Dinner meal slot |
data.meals.[day].[meal].description | string | Human-readable meal description |
data.meals.[day].[meal].recipeId | string? | ID of the associated recipe (if generated) |
Errors
| Status | Description |
|---|---|
401 | Missing or invalid API key |
402 | Premium subscription required |
Try it
Paste your API key and send a live request.
GET
/api/meal-plans/v1/nextcURL
curl -H "X-API-Key: hp_your_key_here" \
https://www.homeplatemeal.com/api/meal-plans/v1/next