Skip to content
Last updated

Retrieve month-by-month usage breakdown for trend analysis.

GEThttps://api.aitronos.com/v1/analytics/usage/monthly/{org_id}

Path Parameters

org_id string required

The organization ID.

Query Parameters

month integer

Specific month to retrieve (1-12).

months integer

Number of months to retrieve. Default: 12.

Returns

Returns monthly usage analytics with trends and comparisons.

Bash
curl "https://api.aitronos.com/v1/analytics/usage/monthly/org_abc123?year=2025&months=6" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

{
  "organization_id": "org_abc123",
  "period": "monthly",
  "data": [
    {
      "month": 11,
      "year": 2025,
      "month_name": "November",
      "total_cost_chf": 1250.75,
      "total_requests": 5000,
      "total_synapses": 2500000.0,
      "total_tokens": 500000,
      "growth_rate_percent": -5.2
    },
    {
      "month": 10,
      "year": 2025,
      "month_name": "October",
      "total_cost_chf": 1320.50,
      "total_requests": 5280,
      "total_synapses": 2640000.0,
      "total_tokens": 528000,
      "growth_rate_percent": 8.5
    }
  ],
  "totalRequests": 10280,
  "totalCost": 2571.25,
  "summary": {
    "year": 2025,
    "start_month": 6,
    "end_month": 11,
    "months_included": 6,
    "currency": "CHF"
  }
}