Developer Documentation

Complete guides for integrating Mealcious with your restaurant or platform.

Getting Started

Mealcious provides a simple REST API and webhooks for integrating nutritional intelligence into your restaurant platform.

Quick Start

  1. 1. Sign up for a Mealcious restaurant account
  2. 2. Get your API key from the dashboard
  3. 3. Upload your menu items
  4. 4. Integrate the API or webhooks
  5. 5. Launch health score badges

Integration Guide

Choose your integration method based on your restaurant system.

POS System Integration

Integrate directly with Square, Toast, or your POS system.

Integration time: 2–4 hours

REST API

Build a custom integration using our REST API.

Integration time: 1–2 days

CSV Upload

Simple CSV file upload for smaller operations.

Integration time: 30 minutes

API Reference

Base URL: https://api.mealcious.com/v1

POST /menus

Upload or update menu items

{
  "restaurant_id": "rest_123",
  "items": [
    {
      "name": "Grilled Salmon",
      "ingredients": ["salmon", "olive oil", "lemon"],
      "calories": 450,
      "protein": 35
    }
  ]
}

GET /menus/:id/recommendations

Get personalized recommendations for a diner

Parameters: diner_profile_id, dietary_restrictions

GET /compliance/report

Generate nutritional compliance reports

Parameters: restaurant_id, date_range

Webhooks

Receive real-time updates from Mealcious.

menu.updated

Triggered when menu items are updated

report.generated

Triggered when a compliance report is ready

recommendation.matched

Triggered when a diner matches with a meal

Health Profiles

Health profiles capture diner dietary preferences, restrictions, and wellness goals for personalized recommendations.

Compliance Reports

Generate automated nutritional compliance reports for regulatory requirements and menu transparency.

Troubleshooting

API Error 401: Unauthorized

Check that your API key is valid and included in the Authorization header.

Recommendations not matching

Ensure diner health profiles are complete with all dietary restrictions.

Menu not updating

Check the webhook logs in your dashboard to confirm successful delivery.

Need Help?

Check our FAQ, explore code examples, or contact our support team for dedicated assistance.

View Support