Meal Plans
Get Current Meal Plan
Retrieve the current week's meal plan for your family.
Request
GET /api/meal-plans/v1/current
Headers
| Header | Required | Description |
|---|---|---|
X-API-Key | Yes | Your Home Plate API key |
Parameters
This endpoint takes no parameters. It automatically returns the meal plan for the current week (Monday through Sunday).
Response
Success (200)
Returns the current week's meal plan, or null if no plan has been generated yet.
{
"data": {
"id": "abc123",
"weekOf": "2026-03-23T00:00:00.000Z",
"meals": {
"Monday": {
"breakfast": {
"description": "Greek yogurt parfait with granola",
"recipeId": "recipe_123"
},
"lunch": {
"description": "Turkey wrap with avocado"
},
"dinner": {
"description": "Grilled salmon with asparagus",
"recipeId": "recipe_456"
}
},
"Tuesday": { ... },
"Wednesday": { ... }
}
}
}
When no meal plan exists for the current 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/currentcURL
curl -H "X-API-Key: hp_your_key_here" \
https://www.homeplatemeal.com/api/meal-plans/v1/current