Skip to content
Last updated

Get usage analytics for your organization at different time granularities: yearly, monthly, daily, or hourly.

Yearly Usage

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

Get multi-year usage trends and patterns for comprehensive analysis.

Path Parameters

org_id string required

The organization ID.

Query Parameters

years integer optional

Number of years to include (1-10, default: 3).


Monthly Usage

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

Get month-by-month usage breakdown for detailed trend analysis.

Path Parameters

org_id string required

The organization ID.

Query Parameters

year integer required

Year to analyze (2020-2030).

month integer optional

Month for validation (1-12).

months integer optional

Number of months to include (1-24, default: 12).


Daily Usage

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

Get day-by-day usage breakdown for operational monitoring.

Path Parameters

org_id string required

The organization ID.

Query Parameters

year integer required

Year (2020-2030).

month integer required

Month (1-12).


Hourly Usage

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

Get hour-by-hour usage patterns for real-time monitoring.

Path Parameters

org_id string required

The organization ID.

Query Parameters

date string required

Date in YYYY-MM-DD format.


Returns

All endpoints return usage data with costs in CHF, request counts, synapses, tokens/neurons, and relevant growth rates or patterns.

cURL
curl "https://api.aitronos.com/v1/analytics/usage/yearly/org_abc123?years=2" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

200 OK
{
  "organization_id": "org_abc123",
  "period": "yearly",
  "data": [
    {
      "year": 2025,
      "total_cost_chf": 12500.50,
      "total_requests": 50000,
      "total_synapses": 25000000.0,
      "total_tokens": 5000000,
      "growth_rate_percent": 15.2
    },
    {
      "year": 2024,
      "total_cost_chf": 10870.25,
      "total_requests": 45000,
      "total_synapses": 22500000.0,
      "total_tokens": 4500000,
      "growth_rate_percent": null
    }
  ],
  "totalRequests": 95000,
  "totalCost": 23370.75,
  "summary": {
    "start_year": 2024,
    "end_year": 2025,
    "years_included": 2,
    "currency": "CHF"
  }
}