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

# Get Organization Usage

> Check your organization's current usage, limits, and remaining quota

## Overview

The Get Organization Usage endpoint allows you to check your organization's current API usage, monthly limits, and remaining quota. This endpoint uses API key authentication and automatically handles billing cycle resets when applicable.

<Note>
  This endpoint requires a valid API key in the request header. The usage information is specific to the organization associated with the API key.
</Note>

## Authentication

<ParamField header="api-key" type="string" required>
  Your organization's API key for authentication. Format: `unsiloed_[hash]`
</ParamField>

## Response

<ResponseField name="org_id" type="string">
  Unique identifier for your organization
</ResponseField>

<ResponseField name="org_name" type="string">
  Name of your organization
</ResponseField>

<ResponseField name="current_usage" type="number">
  Number of credits used in the current billing cycle
</ResponseField>

<ResponseField name="usage_limit" type="number">
  Total monthly usage limit (credits) for your organization
</ResponseField>

<ResponseField name="remaining_quota" type="number">
  Number of credits remaining in the current billing cycle. Calculated as: `usage_limit - current_usage`
</ResponseField>

<ResponseField name="last_billed_date" type="string">
  Date of the last billing cycle reset in ISO 8601 format (YYYY-MM-DD). Usage resets automatically every 30 days.
</ResponseField>


## OpenAPI

````yaml api-reference/openapi.json GET /org/get_usage
openapi: 3.1.0
info:
  title: Unsiloed AI Document Processing API
  description: >-
    A comprehensive API for document processing, extraction, and analysis using
    AI-powered tools
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://prod.visionapi.unsiloed.ai
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /org/get_usage:
    get:
      summary: Get Organization Usage
      description: >-
        Get organization usage information including current usage, monthly
        limit, and remaining quota
      responses:
        '200':
          description: Usage information retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  org_id:
                    type: string
                    description: Unique identifier for your organization
                  org_name:
                    type: string
                    description: Name of your organization
                  current_usage:
                    type: number
                    description: Number of credits used in the current billing cycle
                  usage_limit:
                    type: number
                    description: Total  usage limit (credits) for your organization
                  remaining_quota:
                    type: number
                    description: Number of credits remaining in the current billing cycle
                  last_billed_date:
                    type: string
                    format: date
                    description: Date of the last billing cycle reset (YYYY-MM-DD)
        '401':
          description: Unauthorized - Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: >-
                      API key is required. Please provide 'api-key' in the
                      request header.
        '404':
          description: Organization not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    example: Organization not found
      security:
        - apiKeyAuth: []
      servers:
        - url: https://platformbackend.unsiloed.ai/api/v1
          description: Platform Backend
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: api-key

````