Skip to content
Last updated

🔨 In Development — This section is still being developed and may change.
Retrieve the active monthly and total usage limits for an organization alongside the latest consumption snapshot.
GEThttps://api.freddy.aitronos.com/v1/analytics/{org_id}/usage/{month}/{year}/limits

Path Parameters

orgId string required

Unique organization identifier (format: ORG_ + 16 chars).

month integer required

Target billing month (1-12).

year integer required

Target billing year (e.g., 2025).

Authentication

  • Authorization: Bearer $FREDDY_API_KEY

Returns

Current limit configuration and usage snapshot for the requested billing period.

{
  "organizationId": "ORG_B66136CBB1304C98",
  "period": {
    "month": 10,
    "year": 2025
  },
  "limits": {
    "monthlyApiLimit": 2000.0,
    "totalUsageLimit": 5000.0,
    "currency": "CHF"
  },
  "currentUsage": {
    "currentCost": 1450.67,
    "currentRequests": 15432,
    "currentTokens": 8923456,
    "usagePercentage": 72.5
  }
}

Request example

Bash
curl "https://api.freddy.aitronos.com/v1/analytics/ORG_B66136CBB1304C98/usage/10/2025/limits" \
  -H "Authorization: Bearer $FREDDY_API_KEY"

Response examples

JSON
{
  "organizationId": "ORG_B66136CBB1304C98",
  "period": {
    "month": 10,
    "year": 2025
  },
  "limits": {
    "monthlyApiLimit": 2000.0,
    "totalUsageLimit": 5000.0,
    "currency": "CHF"
  },
  "currentUsage": {
    "currentCost": 1450.67,
    "currentRequests": 15432,
    "currentTokens": 8923456,
    "usagePercentage": 72.5
  }
}