# Get organization usage limits

div
strong
🔨 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.

#### 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.


```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
  }
}
```

## Request example


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


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/analytics/ORG_B66136CBB1304C98/usage/10/2025/limits",
    headers={"Authorization": f"Bearer {api_key}"}
)

data = response.json()
print(data["limits"]["monthlyApiLimit"])
```


```javascript
const response = await fetch(
  'https://api.freddy.aitronos.com/v1/analytics/ORG_B66136CBB1304C98/usage/10/2025/limits',
  {
    headers: {
      'Authorization': `Bearer ${apiKey}`
    }
  }
);

const usageLimits = await response.json();
console.log(usageLimits.limits.monthlyApiLimit);
```

## 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
  }
}
```


```json
{
  "error": {
    "message": "Authentication required",
    "type": "authentication_error",
    "code": "missing_authentication"
  }
}
```


```json
{
  "error": {
    "message": "Access denied for organization",
    "type": "permission_error",
    "code": "insufficient_permissions"
  }
}
```

## Related Resources

- [Get top API usage](/docs/api-reference/organizations/analytics/get-top-api-usage)
- [Update organization API limits](/docs/api-reference/organizations/analytics/update-api-limit)