GridMango API v1

How Authentication Works

1. Create an account or sign in to GridMango.
2. Open Profile and go to API Access.
3. Copy the current bearer token from the profile page.
4. Send that token in every API request:
   Authorization: Bearer <token>

The bearer token is your current signed-in session token. It is not a long-lived API key. Refresh it from Profile when needed.

Entitlements and Feature Gating

API access follows your active GridMango subscription. Requests to tools outside your plan will be rejected.

Discovery and Session Endpoints

• GET /health returns API health.
• GET /tools returns the public customer-facing endpoint manifest.
• GET /auth/me returns the authenticated user, current plan tier, subscription status, and entitled tool keys.

Code Examples

curl -X POST "https://gridmango.com/.netlify/functions/api-v1/baseline/generate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-session-token>" \
  -d '{
    "rows": [
      { "Time": "2026-03-10T17:15:00.000Z", "kW": 2.11 },
      { "Time": "2026-03-10T17:30:00.000Z", "kW": 2.03 }
    ],
    "eventDate": "2026-03-18",
    "eventStartTime": "17:00",
    "eventDuration": 60,
    "method": "xofy",
    "x": 5,
    "y": 10,
    "similarDayRule": "match_event_day",
    "excludeHolidays": false
  }'

import requests

BASE_URL = "https://gridmango.com/.netlify/functions/api-v1"
TOKEN = "your-session-token"

payload = {
    "rows": [
        {"Time": "2026-03-10T17:15:00.000Z", "kW": 2.11},
        {"Time": "2026-03-10T17:30:00.000Z", "kW": 2.03},
    ],
    "eventDate": "2026-03-18",
    "eventStartTime": "17:00",
    "eventDuration": 60,
    "method": "xofy",
    "x": 5,
    "y": 10,
}

response = requests.post(
    f"{BASE_URL}/baseline/generate",
    headers={
        "Authorization": f"Bearer {TOKEN}",
        "Content-Type": "application/json",
    },
    json=payload,
    timeout=60,
)

response.raise_for_status()
print(response.json())

const baseUrl = 'https://gridmango.com/.netlify/functions/api-v1';
const token = 'your-session-token';

const payload = {
  rows: [
    { Time: '2026-03-10T17:15:00.000Z', kW: 2.11 },
    { Time: '2026-03-10T17:30:00.000Z', kW: 2.03 }
  ],
  eventDate: '2026-03-18',
  eventStartTime: '17:00',
  eventDuration: 60,
  method: 'xofy',
  x: 5,
  y: 10
};

const response = await fetch(`${baseUrl}/baseline/generate`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${token}`
  },
  body: JSON.stringify(payload)
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status}`);
}

console.log(await response.json());

Example Workflow

1. Call GET /auth/me to confirm the current session and available access.
2. Call GET /tools to view the available endpoint catalog.
3. Submit a tool request with the bearer token.
4. Store the support reference code returned with any failed request so it can be shared with GridMango support.

Endpoint Reference

{
  "ok": true,
  "data": {
    "userId": "...",
    "email": "[email protected]",
    "isAdmin": false,
    "tokenType": "supabase_session_bearer",
    "planTier": "professional",
    "subscriptionStatus": "active",
    "entitledTools": ["baseline", "loadshape", "timezone", "patching", "eventreplay"]
  }
}

Error Handling

When a request fails, GridMango returns a user-safe error and a support reference code. Share that code with support for investigation.

{
  "ok": false,
  "error": "Unable to process request.",
  "code": "GM-API-AB12CD34"
}