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": "6c47f7f5-f921-4698-910f-95dd7d81310b",
  "period": "2026-06",
  "create": 3,
  "with_context": 1,
  "standard_fill": 0
}

Health

GET/healthNo auth

Liveness probe. No authentication required.

Status codes

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