Get daily consumption | Ara Documentation

{
  "daily": [
    {
      "date": "2024-04-01",
      "group": null,
      "sandbox_minutes": 125.5,
      "tokens": 34500,
      "cost_usd": 27.45
    },
    {
      "date": "2024-04-02",
      "group": null,
      "sandbox_minutes": 98.3,
      "tokens": 28900,
      "cost_usd": 22.1
    },
    {
      "date": "2024-04-03",
      "group": null,
      "sandbox_minutes": 110,
      "tokens": 31000,
      "cost_usd": 24.75
    }
  ],
  "items": [],
  "total": {
    "spend_usd": 74.3,
    "credits_usd": 10,
    "sandbox_minutes": 333.8
  },
  "start_date": "2024-04-01",
  "end_date": "2024-04-03"
}

Returns usage broken down by day over a date range.

_{Scope: analytics:read}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

Organization id or slug. Resolve it with GET /v3/self.

Query parameters

start_datedateOptional

Inclusive start date (YYYY-MM-DD).

end_datedateOptional

Inclusive end date (YYYY-MM-DD).

group_byenumOptional

Optional dimension to group by. Unknown values fall back to the ungrouped daily series.

Allowed values:

Response

Daily consumption.

dailylist of objectsOptional

Per-day series (ungrouped requests).

itemslist of objectsOptional

Per-key totals. Present instead of daily when group_by is set.

totalobjectOptional

start_datedateOptional

end_datedateOptional

$	curl https://api.ara.so/v3/organizations/orgId/consumption/daily \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"