Mahalo Health API Documentation

Welcome to the Mahalo Health API documentation. This guide will help you get started with integrating our healthcare platform into your applications.

Overview

The Mahalo Health API provides programmatic access to patient health data, appointments, messaging, and other healthcare features. Our RESTful API allows you to:

Access patient health metrics and wearable data
Manage appointments and care team communications
Track food logs, medication adherence, and questionnaire responses
Integrate with wearable devices like WHOOP and Oura
Generate and access health reports

Important

All API requests require authentication. Make sure you have your API credentials before starting.

Base URL

All API requests should be made to the following base URL:

https://api.mahalo.health/v1

Your First API Request

Let's make a simple request to get a patient's dashboard data:

curl -X GET "https://api.mahalo.health/v1/app/dashboard" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

The response will include the patient's latest health metrics and summaries:

{
  "vitals": {
    "hrv": {
      "value": 45,
      "unit": "ms",
      "trend": "up",
      "change": 3
    },
    "rhr": {
      "value": 62,
      "unit": "bpm",
      "trend": "down",
      "change": -2
    },
    "sleep": {
      "value": 7.5,
      "unit": "hours",
      "trend": "up",
      "change": 0.5
    }
  },
  "summaries": {
    "readiness_score": 85,
    "activity_score": 78,
    "sleep_score": 82
  },
  "notifications": 3,
  "upcoming_appointments": 1
}

Success!

You've just made your first API request to the Mahalo Health Platform. Continue exploring the documentation to learn about all available endpoints.

Next Steps

Now that you've made your first API request, you can: