> ## Documentation Index > Fetch the complete documentation index at: https://basedash.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List organizations > Lists all organizations where the authenticated user is a member. Results are paginated and ordered by creation date (newest first). ## OpenAPI ````yaml https://charts.basedash.com/api/public/openapi get /api/public/organizations openapi: 3.1.0 info: title: Basedash Public API version: 0.0.0 description: >- API for programmatic access to Basedash features. Use API keys for authentication. contact: name: Basedash Support url: https://basedash.com email: support@basedash.com servers: - url: https://charts.basedash.com description: Production security: [] tags: - name: Organizations description: Manage organizations - name: Groups description: Manage organization groups and memberships - name: Data Sources description: Manage database connections and data sources - name: MCP servers description: Manage MCP server data sources - name: Insights description: Manage generated insights - name: Automations description: Manage automations and automation runs - name: Skills description: Manage organization skills - name: Definitions description: Manage reusable SQL definitions - name: Dashboards description: Manage dashboards and their tabs - name: Charts description: Manage charts and their SQL queries - name: Chats description: >- Chat with the Basedash AI agent about your data. Start a chat by sending a message, then continue the conversation with follow-up messages. The assistant responds asynchronously: pass the `wait` query parameter to receive the finished response in the same request, or poll the assistant message (or stream its events) after an HTTP 202. Chats created through the API are not shown in the Basedash app. paths: /api/public/organizations: get: tags: - Organizations summary: List organizations description: >- Lists all organizations where the authenticated user is a member. Results are paginated and ordered by creation date (newest first). parameters: - schema: type: integer minimum: 1 maximum: 100 default: 50 description: Maximum number of items to return (1-100, default 50) required: false description: Maximum number of items to return (1-100, default 50) name: limit in: query - schema: type: string description: Cursor for pagination (ID of the last item from previous page) required: false description: Cursor for pagination (ID of the last item from previous page) name: cursor in: query - schema: type: string enum: - jwtSecret description: >- Include sensitive fields in the response. Use `jwtSecret` to include the embed JWT secret (only included for organizations where the user is an admin). required: false description: >- Include sensitive fields in the response. Use `jwtSecret` to include the embed JWT secret (only included for organizations where the user is an admin). name: include in: query responses: '200': description: >- Organizations retrieved successfully. The `jwtSecret` field is only included when explicitly requested via `?include=jwtSecret` and only for organizations where the user is an admin. content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string description: Organization ID name: type: string description: Name of the organization slug: type: string description: URL-friendly slug customAiContext: type: - string - 'null' description: Custom context for AI insightsAiContext: type: - string - 'null' description: Custom context injected into AI-generated insights onboardingStatus: type: string enum: - LEGACY - STARTED - COMPLETED description: Onboarding status fullEmbedEnabled: type: boolean description: Full embed enabled flag embedAllowedOrigins: type: array items: type: string description: Allowed embed origins isBillable: type: boolean description: >- [Self-hosted] Whether the organization is billable. Defaults to true. Relevant for self-hosted deployments where billing gates certain features. When false, the organization will not be counted towards billable usage and will have a limited set of features. When true, the organization will be counted towards billable usage (after a 14-day trial) and will have access to all features. insightsEnabled: type: boolean description: >- Whether automated insights generation is enabled for this organization. insightsFrequency: type: string enum: - DAILY - WEEKDAYS - WEEKLY - MONTHLY - NEVER description: >- How often automated insights are generated. NEVER means automatic generation is disabled. insightsPreferredDayOfWeek: type: - number - 'null' description: >- Preferred day of week for weekly insights. 0 is Sunday. insightsPreferredDayOfMonth: type: - number - 'null' description: Preferred day of month for monthly insights. allowOnDemandAiUsage: type: boolean description: >- Whether the organization can continue using AI beyond included monthly AI credits. aiUsageOverageLimitCents: type: - integer - 'null' exclusiveMinimum: 0 maximum: 2147483647 description: >- Maximum AI usage overage for the organization in cents. Null means no limit. billingEmail: type: string description: >- Email address used for billing communication and invoices sendInvoicesToBillingEmail: type: boolean description: >- Whether paid invoices are emailed to the billing email address defaultDashboardAccessAudience: type: string enum: - EVERYONE - CREATOR_ONLY - CREATOR_GROUPS description: Default audience for newly created dashboards defaultDashboardAccessLevel: type: string enum: - MANAGE - EDIT - VIEW description: >- Default permission level for the audience. Creator always gets MANAGE regardless. defaultChatAccessAudience: type: string enum: - EVERYONE - CREATOR_ONLY - CREATOR_GROUPS description: Default audience for newly created chats defaultChatAccessLevel: type: string enum: - MANAGE - EDIT - VIEW description: >- Default permission level for new chats. Creator always gets MANAGE regardless. defaultAutomationAccessAudience: type: string enum: - EVERYONE - CREATOR_ONLY - CREATOR_GROUPS description: Default audience for newly created automations defaultAutomationAccessLevel: type: string enum: - MANAGE - EDIT - VIEW description: >- Default permission level for new automations. Creator always gets MANAGE regardless. trialEndsAt: type: - string - 'null' description: >- [Self-hosted] ISO 8601 date when the trial ends, or null if no trial. Trial starts after the organization is created and becomes billable. jwtSecret: type: string description: JWT secret for embedding required: - id - name - slug - customAiContext - insightsAiContext - onboardingStatus - fullEmbedEnabled - embedAllowedOrigins - isBillable - insightsEnabled - insightsFrequency - insightsPreferredDayOfWeek - insightsPreferredDayOfMonth - allowOnDemandAiUsage - aiUsageOverageLimitCents - billingEmail - sendInvoicesToBillingEmail - defaultDashboardAccessAudience - defaultDashboardAccessLevel - defaultChatAccessAudience - defaultChatAccessLevel - defaultAutomationAccessAudience - defaultAutomationAccessLevel - trialEndsAt pagination: $ref: '#/components/schemas/PaginationMeta' required: - data - pagination '401': description: Unauthorized - Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded - Too many requests content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: PaginationMeta: type: object properties: nextCursor: type: - string - 'null' description: Cursor for the next page (null if no more pages) hasMore: type: boolean description: Whether there are more items after this page required: - nextCursor - hasMore ErrorResponse: type: object properties: error: $ref: '#/components/schemas/ApiError' required: - error RateLimitErrorResponse: type: object properties: error: $ref: '#/components/schemas/RateLimitError' required: - error ApiError: type: object properties: title: type: string description: Error type identifier detail: type: string description: Human-readable error description required: - title - detail RateLimitError: allOf: - $ref: '#/components/schemas/ApiError' - type: object properties: title: type: string enum: - RateLimitExceeded retryAfterMs: type: number description: Milliseconds until the rate limit window resets required: - retryAfterMs securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authentication using Bearer token format: `Bearer ` ````