---
title: "Get an organization"
method: GET
path: "/api/public/organizations/{id}"
tags: ["Organizations"]
---

# Get an organization

`GET /api/public/organizations/{id}`

## Request

- Base URL: `https://charts.basedash.com`
- URL: `https://charts.basedash.com/api/public/organizations/{id}`
- Auth: HTTP bearer

Retrieves an organization by ID. Requires membership in the organization.

## Path parameters

- `id` string, required: Organization ID

## Query parameters

- `include` 'jwtSecret': Include sensitive fields in the response. Use `jwtSecret` to include the embed JWT secret (requires admin access).

## Response `200`

Organization retrieved successfully. The `jwtSecret` field is only included when explicitly requested via `?include=jwtSecret` and the user has admin access.

- object
  - `data` object, required
    - `id` string, required: Organization ID
    - `name` string, required: Name of the organization
    - `slug` string, required: URL-friendly slug
    - `customAiContext` string, nullable, required: Custom context for AI
    - `insightsAiContext` string, nullable, required: Custom context injected into AI-generated insights
    - `onboardingStatus` 'STARTED' | 'COMPLETED', required: Onboarding status
    - `fullEmbedEnabled` boolean, required: Full embed enabled flag
    - `embedAllowedOrigins` string[], required: Allowed embed origins
    - `billingAccountId` string, nullable, required: Billing account this organization is billed through, or null when the organization manages its own billing.
    - `isBillable` boolean, required: [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` boolean, required: Whether automated insights generation is enabled for this organization.
    - `modelsEnabled` boolean, required: Whether Models is shown in the product and creating or editing models is allowed.
    - `automationNotificationsVisible` boolean, required: Whether the Slack and email notifications section is shown on the automation page. Does not affect existing notification delivery or the automations API.
    - `insightsFrequency` 'DAILY' | 'WEEKDAYS' | 'WEEKLY' | 'MONTHLY' | 'NEVER', required: How often automated insights are generated. NEVER means automatic generation is disabled.
    - `insightsPreferredDayOfWeek` number, nullable, required: Preferred day of week for weekly insights. 0 is Sunday.
    - `insightsPreferredDayOfMonth` number, nullable, required: Preferred day of month for monthly insights.
    - `allowOnDemandAiUsage` boolean, required: Whether the organization can continue using AI beyond included monthly AI credits. For an organization attached to a billing account, this controls access beyond the account's pooled included credits for this tenant; the billing account setting still applies to the whole account.
    - `aiUsageOverageLimitCents` integer, nullable, required: Maximum AI usage overage for the organization in cents. For an organization attached to a billing account, this is an absolute cap on that organization’s usage during the account billing period, not a share of the pooled credits. The billing account cap also applies. Null means no tenant limit.
    - `billingEmail` string, required: Email address used for billing communication and invoices
    - `sendInvoicesToBillingEmail` boolean, required: Whether paid invoices are emailed to the billing email address
    - `defaultDashboardAccessAudience` 'EVERYONE' | 'CREATOR_ONLY' | 'CREATOR_GROUPS', required: Default audience for newly created dashboards
    - `defaultDashboardAccessLevel` 'MANAGE' | 'EDIT' | 'VIEW', required: Default permission level for the audience. Creator always gets MANAGE regardless.
    - `defaultChatAccessAudience` 'EVERYONE' | 'CREATOR_ONLY' | 'CREATOR_GROUPS', required: Default audience for newly created chats
    - `defaultChatAccessLevel` 'MANAGE' | 'EDIT' | 'VIEW', required: Default permission level for new chats. Creator always gets MANAGE regardless.
    - `defaultAutomationAccessAudience` 'EVERYONE' | 'CREATOR_ONLY' | 'CREATOR_GROUPS', required: Default audience for newly created automations
    - `defaultAutomationAccessLevel` 'MANAGE' | 'EDIT' | 'VIEW', required: Default permission level for new automations. Creator always gets MANAGE regardless.
    - `trialEndsAt` string, nullable, required: [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` string: JWT secret for embedding. Only returned when `?include=jwtSecret` is specified and the user has admin access.

## Other responses

- `401`: Unauthorized - Missing or invalid API key
- `404`: Not found - Organization not found or no membership
- `429`: Rate limit exceeded - Too many requests
- `500`: Internal server error

---

[API](https://skmtc.dev/basedash/apis/basedash-public-api.md) - [All operations](https://skmtc.dev/basedash/apis/basedash-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/basedash/apis/basedash-public-api/revisions/efb9d40bc6f7?raw)