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

# Get Account Usage

> Requires the `account.read` token ability.



## OpenAPI

````yaml /api-reference/openapi.json get /usage
openapi: 3.1.0
info:
  title: Hosting Panel API
  version: 1.0.0
  description: >-
    The customer-facing hosting panel API. A request is scoped to the hosting
    account its bearer token belongs to; the token abilities decide which
    endpoints it may call.
servers:
  - url: https://hosting-panel.net/api/v1
security:
  - sanctum: []
tags:
  - name: Account
  - name: Domains
  - name: DNS
  - name: Email Accounts
  - name: Forwarders
  - name: Databases
  - name: FTP Accounts
  - name: Cron Jobs
  - name: URL Schedules
  - name: Node.js Applications
  - name: Valkey
  - name: Photon Optimizer
  - name: Statistics
  - name: PSI Metrics
  - name: PHP Versions
paths:
  /usage:
    get:
      tags:
        - Account
      summary: Get Account Usage
      description: Requires the `account.read` token ability.
      operationId: account.usage
      responses:
        '200':
          description: '`AccountUsageResource`'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/AccountUsageResource'
                required:
                  - data
        '401':
          $ref: '#/components/responses/AuthenticationException'
components:
  schemas:
    AccountUsageResource:
      type: object
      properties:
        domains:
          type: object
          properties:
            used:
              type: integer
            limit:
              type:
                - integer
                - 'null'
          required:
            - used
            - limit
        databases:
          type: object
          properties:
            used:
              type: integer
            limit:
              type:
                - integer
                - 'null'
          required:
            - used
            - limit
        emails:
          type: object
          properties:
            used:
              type: integer
            limit:
              type:
                - integer
                - 'null'
          required:
            - used
            - limit
        hosting_disk:
          type: object
          properties:
            used_bytes:
              type: integer
            limit_bytes:
              type:
                - integer
                - 'null'
          required:
            - used_bytes
            - limit_bytes
        email_disk:
          type: object
          properties:
            used_bytes:
              type: integer
            limit_bytes:
              type:
                - integer
                - 'null'
          required:
            - used_bytes
            - limit_bytes
      required:
        - domains
        - databases
        - emails
        - hosting_disk
        - email_disk
      title: AccountUsageResource
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
  securitySchemes:
    sanctum:
      type: http
      description: >-
        An API access token, sent as `Authorization: Bearer <token>`. Its
        abilities decide which endpoints it may call.
      scheme: bearer

````