> ## Documentation Index
> Fetch the complete documentation index at: https://www.unsiloed.ai/docs/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.

> [!WARNING]
>
> This endpoint is served from a different base URL than the document-processing APIs:
>
> ```
> GET https://platformbackend.unsiloed.ai/api/v1/org/get_usage
> ```
>
> `https://prod.visionapi.unsiloed.ai/org/get_usage` returns `404`.

## Authentication

**api-key** `string` *required*

Your organization's API key for authentication. Format: `unsiloed_[hash]`

## Response

**org\_id** `string`

Unique identifier for your organization

**org\_name** `string`

Name of your organization

**current\_usage** `number`

Number of credits used in the current billing cycle

**usage\_limit** `number`

Total monthly usage limit (credits) for your organization

**remaining\_quota** `number`

Number of credits remaining in the current billing cycle. Calculated as: `usage_limit - current_usage`

**last\_billed\_date** `string`

Date of the last billing cycle reset in ISO 8601 format (YYYY-MM-DD). Usage resets automatically every 30 days.


## 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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.