# Get usage summary

Get comprehensive overview with all-time totals and top models.

#### Path Parameters

**`org_id`** string required

The organization ID.

## Returns

Returns comprehensive usage summary including all-time totals, top models, current month data, and time range information.


```bash
curl "https://api.aitronos.com/v1/analytics/usage/summary/org_abc123" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
org_id = "org_abc123"

response = requests.get(
    f"https://api.aitronos.com/v1/analytics/usage/summary/{org_id}",
    headers={"X-API-Key": api_key}
)

data = response.json()
print(f"Total cost: {data['totalCost']} CHF")
print(f"Top model: {data['topModels'][0]['model']}")
```


```javascript
const response = await fetch(
  "https://api.aitronos.com/v1/analytics/usage/summary/org_abc123",
  {
    headers: {
      "X-API-Key": process.env.FREDDY_API_KEY
    }
  }
);

const data = await response.json();
console.log(`Total cost: ${data.totalCost} CHF`);
console.log(`Top model: ${data.topModels[0].model}`);
```

**Response:**

200 OK

```json
{
  "organization_id": "org_abc123",
  "totalRequests": 150000,
  "total_synapses": 75000000.0,
  "totalNeurons": 1500000.0,
  "totalCost": 37500.0,
  "averageCostPerRequest": 0.25,
  "topModels": [
    {
      "model": "gpt-4o",
      "cost": 22500.0,
      "requests": 90000,
      "percentage": 60.0
    },
    {
      "model": "gpt-4o-mini",
      "cost": 7500.0,
      "requests": 45000,
      "percentage": 20.0
    }
  ],
  "currentMonth": {
    "cost": 1250.75,
    "requests": 5000
  },
  "timeRange": {
    "start": "2024-01-01",
    "end": "2025-11-15",
    "period": "all_time"
  }
}
```

401 Unauthorized

```json
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required",
    "system_message": "No API key provided",
    "type": "client_error",
    "status": 401,
    "trace_id": "abc-123-def",
    "timestamp": "2025-11-15T10:30:00Z"
  }
}
```

403 Forbidden

```json
{
  "success": false,
  "error": {
    "code": "ORGANIZATION_ACCESS_DENIED",
    "message": "Access denied to organization",
    "system_message": "API key doesn't belong to organization",
    "type": "authorization_error",
    "status": 403,
    "trace_id": "def-456-ghi",
    "timestamp": "2025-11-15T10:30:00Z"
  }
}
```

500 Server Error

```json
{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred",
    "system_message": "Database query failed",
    "type": "server_error",
    "status": 500,
    "trace_id": "jkl-012-mno",
    "timestamp": "2025-11-15T10:30:00Z"
  }
}
```