> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypergate.store/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage Stats

> GET /v1/usage — job counts for your team token.

## Endpoint

```
GET /v1/usage
```

## Request

<ParamField header="Authorization" type="string" required>
  `Bearer <your-token>`
</ParamField>

## Example

```bash theme={null}
curl "https://hypergate.store/v1/usage" \
  -H "Authorization: Bearer <your-token>"
```

## Response `200`

```json theme={null}
{
  "resets_at": "2026-09-01T00:00:00.000Z",
  "jobs": {
    "total": 42,
    "completed": 38,
    "failed": 4
  }
}
```

| Field | Description |
| - | - |
| `resets_at` | ISO timestamp for the start of the next billing cycle (first day of next month, UTC). |
| `jobs.total` | Cumulative job count for your token. |
| `jobs.completed` | Cumulative completed jobs. |
| `jobs.failed` | Cumulative failed jobs. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.