> ## Documentation Index > Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get organization > Retrieve the organization (agency, reseller, white-label partner or enterprise) the API key's workspace belongs to: its type, what it may do (`capabilities`), its capacity quotas, branding and client count. Requires the API key creator (or the connected MCP user) to hold an organization role (`ORGANIZATION_MANAGER` or `ORGANIZATION_ADMIN`) in the workspace the key belongs to. A workspace admin role alone grants no organization access. An API key needs `WORKSPACE_READ` for these reads: `WORKSPACE_WRITE` does not include it. For organizations (agencies, resellers, white-label partners, enterprises) and their client workspaces only. The organization role is checked first: a caller without one is refused with 403 (`ORGANIZATION_READ_FORBIDDEN` on reads, `ORGANIZATION_ADMIN_FORBIDDEN` on writes), and a caller with one whose workspace is not in a live organization gets 404 `NOT_IN_ORGANIZATION`. > **Required scope:** `WORKSPACE_READ` > > **Rate limit:** 100 requests per minute ## OpenAPI ````yaml https://openapi.enginy.ai/definitions.json get /v1/organization openapi: 3.1.0 info: title: Enginy API version: 1.0.0 description: Public API for Enginy platform servers: - url: https://openapi.enginy.ai description: Configured server security: [] tags: - name: AI Variables description: >- Manage AI variables and discover the entity fields you can reference in prompts and entity requests. - name: Inbox description: >- Inbox endpoints for listing contact threads, reading thread messages, managing tags, and sending manual replies. - name: Workspace description: >- The API key's workspace: its capacity, its organization, where its users open the app and where an admin buys more. - name: Organization description: >- For organizations (agencies, resellers, white-label partners, enterprises) and their client workspaces only. Create client workspaces, distribute credits and identity slots between them, and buy or request more capacity. Upsell and management only: no endpoint lowers the contracted quota. Clients billed through self-serve billing keep their own plan. Requires an organization role. - name: Workflows description: >- Build, validate, publish, run, and inspect advanced (graph) workflows, plus the block/condition catalog needed to author a workflow plan. paths: /v1/organization: get: tags: - Organization summary: Get organization description: >- Retrieve the organization (agency, reseller, white-label partner or enterprise) the API key's workspace belongs to: its type, what it may do (`capabilities`), its capacity quotas, branding and client count. Requires the API key creator (or the connected MCP user) to hold an organization role (`ORGANIZATION_MANAGER` or `ORGANIZATION_ADMIN`) in the workspace the key belongs to. A workspace admin role alone grants no organization access. An API key needs `WORKSPACE_READ` for these reads: `WORKSPACE_WRITE` does not include it. For organizations (agencies, resellers, white-label partners, enterprises) and their client workspaces only. The organization role is checked first: a caller without one is refused with 403 (`ORGANIZATION_READ_FORBIDDEN` on reads, `ORGANIZATION_ADMIN_FORBIDDEN` on writes), and a caller with one whose workspace is not in a live organization gets 404 `NOT_IN_ORGANIZATION`. > **Required scope:** `WORKSPACE_READ` > > **Rate limit:** 100 requests per minute responses: '200': description: The organization content: application/json: schema: type: object properties: status: type: string enum: - success message: type: string data: type: object properties: id: type: number name: type: string type: type: string enum: - AGENCY - RESELLER - WHITE_LABEL - ENTERPRISE pricingTier: type: string capabilities: type: object properties: showPricing: type: boolean showProgramTier: type: boolean showBrandingSettings: type: boolean showContract: type: boolean pricingVisibleInAccounts: type: boolean purchaseMode: type: string enum: - self-serve - request description: >- `self-serve`: buy capacity with `POST /v1/organization/capacity/purchases`. `request`: ask Enginy with `POST /v1/organization/capacity/requests`. canBrand: type: boolean canCustomDomain: type: boolean required: - showPricing - showProgramTier - showBrandingSettings - showContract - pricingVisibleInAccounts - purchaseMode - canBrand - canCustomDomain quotas: type: object properties: maxAccounts: type: - number - 'null' maxIdentities: type: - number - 'null' maxCredits: type: - number - 'null' required: - maxAccounts - maxIdentities - maxCredits branding: type: object properties: brandingEnabled: type: boolean brandName: type: - string - 'null' brandLogoUrl: type: - string - 'null' brandFaviconUrl: type: - string - 'null' supportEmail: type: - string - 'null' required: - brandingEnabled - brandName - brandLogoUrl - brandFaviconUrl - supportEmail clientsCount: type: number required: - id - name - type - pricingTier - capabilities - quotas - branding - clientsCount required: - status - message - data '400': description: >- Invalid request, or the capacity change is refused (`details.code`: `POOL_HEADROOM_EXCEEDED`, `MOVE_EXCEEDS_BUDGET`, `MOVE_EXCEEDS_IDENTITY_SLOTS`, `IDENTITY_CAP_BELOW_CONNECTED`, `BELOW_ADD_ON_CREDITS`, `ACCOUNT_LIMIT_REACHED`, `CREDITS_NOT_IN_INCREMENTS`, `PURCHASE_NEEDS_QUOTA` or `CAPACITY_IS_PURCHASED`) '401': description: Missing or invalid API key, or the workspace is frozen or deleted '403': description: >- The API key lacks the scope (`missingScopes`), its creator lacks the organization role (`details.code`: `ORGANIZATION_READ_FORBIDDEN` or `ORGANIZATION_ADMIN_FORBIDDEN`), or the operation is not available to this organization or client (`ACCOUNT_BILLED_SELF_SERVE`, `NO_CONTRACT_VIEW`, `PURCHASES_ARE_REQUESTED`, `PURCHASE_NEEDS_BILLING_AGREEMENT`) '404': description: >- The workspace is not in an organization (`details.code`: `NOT_IN_ORGANIZATION`, `ORGANIZATION_NOT_FOUND`), or the client is not one of its live clients (`ACCOUNT_NOT_FOUND`) '412': description: >- Enginy has not set the organization quota this change allocates from yet (`details.code`: `QUOTA_NOT_SET`) '429': description: Rate limit exceeded; retry after `X-RateLimit-Retry-After-Seconds` security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.