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

# How much of the plan is left right now

> Every window the plan enforces: the limit, how much is used, how much is left, and when it frees up. Windows are ROLLING, not calendar — burning the hourly allowance at 10:59 does not hand back a fresh one at 11:00 — so `resets_at` is the moment the oldest call in that window ages out, which is a real time to retry rather than a guess.

Inbound calls count towards usage and are never refused by these limits: a person cannot control who rings them.

Workspaces on plans without fair-use ceilings get `limited: false` and an empty `windows` list.



## OpenAPI

````yaml /api-reference/openapi.json get /usage
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Public REST API for Brilo. Authenticate by sending your API key as a Bearer
    token in the `Authorization` header.
  title: Brilo API
  version: '2025-03-02'
servers:
  - description: Production
    url: https://api.brilo.ai/v1
security: []
tags: []
paths:
  /usage:
    get:
      tags:
        - Usage
      summary: How much of the plan is left right now
      description: >-
        Every window the plan enforces: the limit, how much is used, how much is
        left, and when it frees up. Windows are ROLLING, not calendar — burning
        the hourly allowance at 10:59 does not hand back a fresh one at 11:00 —
        so `resets_at` is the moment the oldest call in that window ages out,
        which is a real time to retry rather than a guess.


        Inbound calls count towards usage and are never refused by these limits:
        a person cannot control who rings them.


        Workspaces on plans without fair-use ceilings get `limited: false` and
        an empty `windows` list.
      operationId: UsageController_read
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsageResponseDto'
          description: ''
      security:
        - bearerAuth: []
components:
  schemas:
    UsageResponseDto:
      properties:
        concurrent_calls:
          description: How many calls may be in flight at once, inbound or outbound.
          example: 1
          type: number
        limited:
          description: >-
            False for plans with no fair-use ceilings. `windows` is then empty,
            and nothing here refuses a call.
          type: boolean
        max_call_minutes:
          description: Longest single call, in minutes. Not a window; a per-call cap.
          example: 60
          type: number
        windows:
          items:
            $ref: '#/components/schemas/UsageWindowDto'
          type: array
      required:
        - limited
        - windows
        - max_call_minutes
        - concurrent_calls
      type: object
    UsageWindowDto:
      properties:
        key:
          description: >-
            Which ceiling this is. Matches the `code` on the refusal you would
            get for breaching it, so the two can be correlated without a lookup
            table.
          example: calls_per_day
          type: string
        label:
          description: Say this to a person.
          example: Calls today
          type: string
        limit:
          example: 100
          type: number
        remaining:
          description: Never below zero, even if a window was over-spent.
          example: 38
          type: number
        resets_at:
          description: >-
            ISO-8601. When the OLDEST activity in this rolling window ages out,
            which is the first moment retrying can succeed.
          example: '2026-09-22T09:14:00.000Z'
          type: string
        used:
          example: 12
          type: number
      required:
        - key
        - label
        - limit
        - used
        - remaining
        - resets_at
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: Enter your API key (Bearer token)
      scheme: bearer
      type: http

````