# Usage

> Check the meter before you order.

Read the credit balance for the current billing period. Purely informational — it does not consume credits.

## Get current usage

```http
GET /v1/usage
```

Returns purchased, used and remaining requests for the active billing period.

- **Auth:** Bearer token
- **Token abilities:** `api_requests`
- **Gates:** logApiRequest
- **Credits:** Free — no credits consumed.

### Responses

**200** — Usage for the active period.

```json
{
    "period_start_date": "2026-05-01T00:00:00Z",
    "period_end_date": "2026-05-31T23:59:59Z",
    "period_purchased_requests": 1000,
    "period_used_requests": 240,
    "period_available_requests": 760
}
```

**401** — Missing or invalid token.

```json
{
    "message": "Unauthenticated."
}
```

> The response carries an `X-Request-Uuid` header you can quote in support tickets.

### Examples

*Curl*

```bash
curl https://snapsbrew.com/api/v1/usage \
  -H 'Authorization: Bearer <your-token>' \
  -H 'Accept: application/json'
```