API Reference

Complete reference for the Mini Metrics API endpoints.

Authentication

All API requests require authentication using your API key. Include it in the request header:

x-api-key: YOUR_API_KEY

Ingest Endpoints

Base URL: https://mnmt.dev

GET/

Send an event using query parameters. Also available at https://mnmt.dev

GET /?m=metric.name&v=1&d=dimension&k=YOUR_API_KEY

Parameters:
  m  - metric name (required)
  v  - value (optional, defaults to 1)
  d  - dimension (optional, defaults to "default")
  k  - API key (required)

POST/

Send one or more events via JSON body.

// Single event
{
  "m": "metric.name",   // required, string (max 64 chars)
  "v": 1,               // optional, number (defaults to 1)
  "d": "dimension"      // optional, string for grouping
}

// Batch events
[
  {"m": "metric.one", "v": 1},
  {"m": "metric.two", "v": 2, "d": "category"}
]

POST/otlp/metrics

Send metrics in OpenTelemetry format.

Query Endpoints

Base URL: https://api.minimetrics.dev

GET/metrics

List all metrics for your account.

POST/query

Query metric data.

{
  "metricName": "metric.name",  // required
  "timeRange": "24h",           // optional: 5m, 1h, 24h, 7d, 30d, 90d
  "dimension": true             // optional: group by dimension
}

PATCH/metrics/:metricName

Update metric settings (unit, color).

{
  "unit": "ms",      // optional
  "color": "#22c55e" // optional
}

Rate Limits

Tier	Events/Month	Max Query Range
Free	10,000	7 days
Starter	100,000	30 days
Pro	1,000,000	90 days