## Get usage history

`ai_gateway.billing.usage_history(BillingUsageHistoryParams**kwargs)  -> BillingUsageHistoryResponse`

**get** `/accounts/{account_id}/ai-gateway/billing/usage-history`

Retrieve aggregated usage meter event summaries for the given time range.

### Parameters

- `account_id: str`

- `value_grouping_window: Literal["day", "hour"]`

  Grouping window for usage data.

  - `"day"`

  - `"hour"`

- `end_time: Optional[float]`

  End time as Unix timestamp in milliseconds.

- `start_time: Optional[float]`

  Start time as Unix timestamp in milliseconds.

### Returns

- `class BillingUsageHistoryResponse: …`

  - `history: List[History]`

    - `id: str`

    - `aggregated_value: float`

    - `end_time: float`

    - `start_time: float`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
response = client.ai_gateway.billing.usage_history(
    account_id="account_id",
    value_grouping_window="day",
)
print(response.history)
```

#### Response

```json
{
  "errors": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 0,
      "message": "message"
    }
  ],
  "result": {
    "history": [
      {
        "id": "id",
        "aggregated_value": 0,
        "end_time": 0,
        "start_time": 0
      }
    ]
  },
  "success": true,
  "result_info": {
    "has_more": true,
    "page": 0,
    "per_page": 0,
    "total_count": 0
  }
}
```