Engramma

Usage

beginner

Monitor API usage, pattern consumption, latency metrics, and limits.

Usage summary

GET/v1/usage/summary

Get a summary of your current billing cycle's usage against plan limits.

200Response
{
  "cycle_start": "2026-01-15T00:00:00Z",
  "cycle_end": "2026-02-15T00:00:00Z",
  "stores": 1523,
  "queries": 8234,
  "composes": 342,
  "explains": 450,
  "predicts": 120,
  "patterns_peak": 4523,
  "api_calls_total": 12847,
  "errors": 23,
  "daily_queries": 274,
  "daily_stores": 51,
  "daily_composes": 11,
  "limits": {
    "max_patterns": 100000,
    "max_queries_day": -1,
    "max_compose_day": -1,
    "included_queries_month": -1,
    "included_composes_month": -1
  },
  "overage": {
    "overage_queries": 0,
    "overage_stores": 0,
    "overage_composes": 0,
    "overage_explains": 0,
    "overage_predicts": 0,
    "overage_cost_usd": 0
  }
}
curl https://api.engramma-memory.com/v1/usage/summary \
  -H "X-API-Key: $ENGRAMMA_API_KEY"

Usage history

GET/v1/usage/history

Get daily historical usage data.

daysintegerDefault: 30

Number of days of history to return.

200Response
[
  {
    "date": "2026-01-29",
    "queries": 274,
    "stores": 51,
    "composes": 11,
    "explains": 15,
    "predicts": 4
  },
  {
    "date": "2026-01-28",
    "queries": 312,
    "stores": 89,
    "composes": 8,
    "explains": 22,
    "predicts": 7
  }
]
curl "https://api.engramma-memory.com/v1/usage/history?days=7" \
  -H "X-API-Key: $ENGRAMMA_API_KEY"

Latency metrics

GET/v1/usage/latency

Get latency percentiles (p50, p95, p99) over a recent period.

hoursintegerDefault: 24

Number of hours to look back.

200Response
[
  {
    "time": "2026-01-30T14:00:00Z",
    "p50": 8.2,
    "p95": 32.5,
    "p99": 89.1
  },
  {
    "time": "2026-01-30T13:00:00Z",
    "p50": 7.8,
    "p95": 28.4,
    "p99": 75.3
  }
]
curl "https://api.engramma-memory.com/v1/usage/latency?hours=6" \
  -H "X-API-Key: $ENGRAMMA_API_KEY"

Next steps

GDPRSecurity