v4.1.0Home

GET /v1/me

Returns the current user, their plan, and usage limits. Useful as a token health check and to gate features client-side.

Endpoint

http
GET /v1/me

Example request

bash
curl https://api.foxora.ai/v1/me \
  -H "Authorization: Bearer $FOXORA_API_KEY"

Example response

json
{
  "id": "usr_8a2f...",
  "email": "you@example.com",
  "plan": {
    "id": "pro",
    "label": "Pro",
    "renews_at": "2026-05-19T00:00:00Z"
  },
  "usage": {
    "requests_this_month": 1842,
    "tokens_this_month": 942103,
    "spend_usd": 12.41
  },
  "limits": {
    "requests_per_minute": 300,
    "tokens_per_minute": 400000,
    "monthly_spend_cap_usd": 100
  },
  "features": {
    "cloud_agents": true,
    "ember_os": true,
    "team_workspaces": false
  }
}

Companion endpoint

For a day-by-day breakdown of activity, use GET /v1/me/usage. The dashboard’s heatmap on Overview is built from this exact endpoint.

bash
curl "https://api.foxora.ai/v1/me/usage?days=30" \
  -H "Authorization: Bearer $FOXORA_API_KEY"