Introduction
Introduction
Learn about the Home Plate API and what you can build with it.
The Home Plate API gives you programmatic access to your family's meal planning data. Use it to build integrations with smart home systems, create custom dashboards, sync with grocery delivery services, or automate your kitchen workflow.
What you can do
- Retrieve meal plans — Get your family's current weekly meal plan with all meals organized by day
- Access shopping lists — Pull consolidated shopping lists generated from your meal plans
- Build integrations — Connect Home Plate to smart displays, home automation, or other apps
Requirements
The Home Plate API is available exclusively to Premium subscribers (monthly or yearly plan). Upgrade your plan to get started.
How it works
- Sign in to the your profile page with your Home Plate account
- Generate an API key — you'll get a key starting with
hp_ - Make requests using the
X-API-Keyheader - Receive JSON responses with your meal planning data
Base URL
All API requests are made to:
https://www.homeplatemeal.com/api
Versioning
The Home Plate API uses per-resource versioning. Each resource (e.g., meal plans, recipes) has its own version number in the URL path:
/api/meal-plans/v1/current
/api/recipes/v1/saved # coming soon
This means we can evolve individual resources independently. When we release v2 of meal plans, your v1 integrations continue working without changes.