---
title: "Current usage"
method: GET
path: "/v1/usage"
tags: ["Account"]
---

# Current usage

`GET /v1/usage`

## Request

- Base URL: `https://api.briefgate.dev`
- URL: `https://api.briefgate.dev/v1/usage`
- Auth: HTTP bearer

Return current-period usage counters: active intakes, storage consumed, seats, and SMS credits remaining. Useful for agents that need to check quota before creating intakes. Accepts both session auth (dashboard) and API key auth (agents).

## Response `200`

Usage counters

- object
  - `tier` 'free' | 'solo' | 'studio' | 'agency', required
  - `active_intakes` object, required
    - `used` integer
    - `limit` integer, nullable: null when billing is disabled.
  - `storage` object, required
    - `used_bytes` integer
    - `limit_bytes` integer, nullable: null when billing is disabled.
  - `seats` object, required
    - `used` integer
    - `limit` integer
  - `sms_credits` integer, required
  - `subscription` object, required: Whether a Stripe subscription exists for this account. Add-ons attach to it, so an account whose tier was granted directly cannot buy one.
    - `active` boolean, required
  - `rate_limit_per_hour` integer, required
  - `invites_per_day` integer, nullable: Invitations per UTC day; null means no daily limit.
  - `features` object, required: Feature flags for the current effective tier.
  - `chase_schedules` string[], required: Chase schedules this account may set on an intake right now — what assertChaseSchedule actually enforces, including the billing-disabled dev bypass. Free normally allows only `default` and `off`.

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/briefgate/apis/briefgate-api.md) · [All operations](https://skmtc.dev/briefgate/apis/briefgate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/briefgate/apis/briefgate-api/revisions/b21afed4748b?raw)