> ## Documentation Index > Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get capacity > How many computers the account may run and runs, and how many more of each size it may add. Reads the account's capacity: its limits and what it uses, what it has added beyond its plan, its self-serve cap, and how many more computers of each size it may add right now. Use it before a purchase to know what fits, and after one to see the new limits. Capacity is billed to the whole account, so this endpoint needs an account-wide API key. A workspace-scoped key returns `403` with code `account_key_required`. ```bash theme={null} curl https://www.orgo.ai/api/account/capacity \ -H "Authorization: Bearer $ORGO_API_KEY" ``` ```json theme={null} { "plan": "startup_v2", "computers": { "limit": 34, "in_use": 31 }, "ram_gb": { "limit": 272, "in_use": 248 }, "added": { "computers": 30, "ram_gb": 240, "vcpu": 15, "disk_gb": 1200 }, "self_serve_cap": { "computers": 30, "ram_gb": 800, "vcpu": 50, "disk_gb": 2000 }, "can_add": { "small": 0, "medium": 0, "large": 0, "xl": 0, "2xl": 0 }, "max_per_request": 500, "sizes": [ { "size": "small", "ram_gb": 4, "vcpu": 0.5, "disk_gb": 20, "monthly_usd": 14 }, { "size": "medium", "ram_gb": 8, "vcpu": 1, "disk_gb": 40, "monthly_usd": 25 } ], "terms": ["monthly", "yearly"], "windows_available": true, "has_subscription": true, "renews_at": "2026-11-01T00:00:00.000Z", "scheduled_reduction": null } ``` `can_add` at `0` with `added.computers` equal to `self_serve_cap.computers` means the account has reached its self-serve cap. [Ask us](mailto:support@orgo.ai) and we raise it for the account, at the same prices. ## OpenAPI ````yaml GET /account/capacity openapi: 3.1.0 info: title: Orgo API description: >- Launch cloud computers that AI agents can control and interact with. Create workspaces, provision computers, and control them programmatically. version: 2.0.0 contact: name: Orgo Support email: spencer@orgo.ai url: https://orgo.ai servers: - url: https://www.orgo.ai/api description: Production security: - bearerAuth: [] tags: - name: Account description: >- Account capacity: how many computers an account may run, and adding or giving back more. - name: Workspaces description: Organize computers into named workspaces - name: Computers description: Provision and manage virtual computers - name: Computer Lifecycle description: Start, stop, and restart computers - name: Computer Actions description: Control mouse, keyboard, and execute commands - name: Screens description: >- More than one desktop on a single computer. Each screen is its own X server with its own cursor and window manager, so an agent working on one cannot disturb another. - name: Files description: Upload and download files - name: Templates description: Author, build, and launch reproducible computers from templates paths: /account/capacity: get: tags: - Account summary: Get account capacity description: >- What the account may run and runs, what it has added beyond its plan, its self-serve cap, how many more of each size it may add, and every size with its monthly price. Needs an account-wide API key: a workspace-scoped key returns `403`. operationId: getAccountCapacity responses: '200': description: The account's capacity. content: application/json: schema: $ref: '#/components/schemas/AccountCapacity' '401': description: Missing or invalid API key. content: application/json: schema: type: object properties: error: type: string code: type: string '403': description: A workspace-scoped key (`account_key_required`). content: application/json: schema: type: object properties: error: type: string code: type: string '429': description: Rate limited. Retry after the `Retry-After` header. content: application/json: schema: type: object properties: error: type: string code: type: string components: schemas: AccountCapacity: type: object properties: plan: type: string description: The account's plan, such as `startup_v2`. computers: type: object description: >- How many computers the account may run (its plan plus what it has added) and runs. properties: limit: type: integer in_use: type: integer ram_gb: type: object description: The account-wide RAM pool and what its computers use. properties: limit: type: number in_use: type: number added: type: object properties: computers: type: integer ram_gb: type: number vcpu: type: number disk_gb: type: number description: What the account has added beyond its plan. self_serve_cap: type: object properties: computers: type: integer ram_gb: type: number vcpu: type: number disk_gb: type: number description: >- The most the account may add on its own. Past it, purchases return `403` `capacity_cap`; ask us and we raise it for the account. can_add: type: object description: >- How many more computers of each size the account may add now, under its cap. properties: small: type: integer medium: type: integer large: type: integer xl: type: integer 2xl: type: integer max_per_request: type: integer description: The most computers one purchase may add (500). sizes: type: array items: type: object properties: size: type: string enum: - small - medium - large - xl - 2xl ram_gb: type: number vcpu: type: number disk_gb: type: number monthly_usd: type: number terms: type: array items: type: string enum: - monthly - yearly windows_available: type: boolean has_subscription: type: boolean renews_at: type: - string - 'null' format: date-time scheduled_reduction: type: - object - 'null' properties: added_computers: type: integer effective_at: type: string format: date-time securitySchemes: bearerAuth: type: http scheme: bearer description: API key authentication. Get your key at orgo.ai/workspaces ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.