# Get usage heatmap

Retrieve usage heatmap data for visualizing patterns across different time periods and days of the week.

#### Path Parameters

**`org_id`** string required

The organization ID.

#### Query Parameters

**`days`** integer

Number of days to analyze. Default: `30`. Range: 7-90.

**`metric`** string optional

Metric type to analyze: `neurons`, `synapses`, or omit for combined metrics. Default: combined (null).

#### Returns

Returns heatmap data showing usage intensity across time periods.


```bash
curl "https://api.aitronos.com/v1/analytics/usage/heatmap/org_abc123?days=30" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
response = requests.get(
    f"https://api.aitronos.com/v1/analytics/usage/heatmap/org_abc123",
    params={"days": 30},
    headers={"X-API-Key": api_key}
)
```


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