# QuotaUsageRecord

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/quotausagerecord/
> Summary: OpenAPI request or response schema for QuotaUsageRecord, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

A scope's consumption in the current period.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `tenantId` | yes | `string` | The tenant identifier. | — |
| `agentName` | yes | `string` | The agent name. An empty string (`""`) means the tenant-wide counter. | — |
| `period` | yes | [`QuotaPeriod`](/http-api/schemas/quotaperiod/) | The counter's interval. | — |
| `periodStart` | yes | `string (date)` | The first day of the period (in local time). | — |
| `runs` | no | `integer (int64)` | The number of runs completed in the period. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `tokens` | no | `integer (int64)` | The total tokens spent in the period. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `cost` | no | `number (double)` | The total amount spent in the period. Runs with undefined pricing are <strong>not included</strong> in this total (not even added as zero). | pattern `^-?(?:0\\|[1-9]\d*)(?:\.\d+)?$` |
| `updatedAt` | yes | `string (date-time)` | The last-updated time (UTC). | — |