docs

Usage & health

Check your metered usage for the current billing period, and probe service health.

Usage

GET/usageBearer auth

Return billed-action counts for the current period, broken down by kind.

Status codes

  • 200The usage breakdown.
  • 401Missing or invalid API key.
curl https://api.getemboss.ai/usage \
  -H "Authorization: Bearer sk_live_yourkey"
Response
{
  "owner": "owner_42",
  "period": "2026-06",
  "total": {
    "create": 12,
    "with_context": 8,
    "straight_fill": 5,
    "conversation_turn": 31
  },
  "period_counts": {
    "create": 12,
    "with_context": 8,
    "straight_fill": 5,
    "conversation_turn": 31
  }
}

Health

GET/healthNo auth

Liveness probe. No authentication required.

Status codes

  • 200Service is healthy.
curl https://api.getemboss.ai/health
Response
{
  "status": "ok"
}