← All Docs

API

Programmatic access to your meal tracking data via the REST API.

Public API

mealtally offers a REST API for programmatic access to your meal tracking data. Use it to build integrations, export data to other apps, or create custom dashboards.

The API supports:

  • Reading meals — list all meals or fetch a single meal with full nutrition data and individual food items.
  • Submitting meals — send free-text meal descriptions for AI-powered nutrition parsing.
  • Nutrition summaries — retrieve daily or weekly calorie and macro aggregates.

Full interactive documentation with request/response schemas and examples is available at api.mealtally.com/docs.

API Quick Start

  1. Generate an API key — Go to Settings → API Keys on your mealtally dashboard and create a new key with the scopes you need.
  2. Make your first request — Pass the key as a Bearer token:
    curl -H "Authorization: Bearer tm_your_key" https://api.mealtally.com/api/v1/meals
  3. Explore the docs — Visit the interactive API reference for detailed schemas, parameters, and examples.
API keys are scoped to specific permissions: meals:read, meals:write, and summary:read. Only grant the scopes your integration needs.