<!-- Generated by scripts/generate_endpoint_docs.py — do not edit by hand. -->
# `api.contacts.get_history_aggregated`

> `GET /contacts/{contactId}/history/aggregated` — ACPortal

**Python**

```python
api.contacts.get_history_aggregated(contact_id: str) -> ContactHistoryAggregated
```

**CLI**

```bash
ab contacts get_history_aggregated <contact_id>
```

GET /contacts/{contactId}/history/aggregated

## Query parameters — `ContactHistoryParams`

| Field | Type | Required | Description |
|---|---|---|---|
| `statuses` | `Optional[str]` | no | Comma-separated status filters |

## Response

Returns `ContactHistoryAggregated`.

| Field | Type | Required | Description |
|---|---|---|---|
| `summary` | `Optional[dict]` | no | Aggregated summary |
| `byType` | `Optional[list[dict]]` | no | Breakdown by type |

---

[← Back to api.contacts](../contacts.md)