> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kash.bot/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/organizations/:id

> Get public metadata for a specific organization

Fetches public-safe metadata for an organization by its UUID. Sensitive data (credentials, billing) is never returned.

## Endpoint

```
GET https://app.kash.bot/api/organizations/:id
```

## Path Parameters

<ParamField path="id" type="string" required>
  The unique organization identifier (UUID format)
</ParamField>

## Response

<ResponseField name="organization" type="object">
  Organization metadata (public-safe fields only)

  <Expandable title="Organization Object">
    <ResponseField name="id" type="string">
      Unique organization identifier
    </ResponseField>

    <ResponseField name="name" type="string">
      Organization name
    </ResponseField>

    <ResponseField name="slug" type="string">
      URL-friendly slug
    </ResponseField>

    <ResponseField name="displayName" type="string">
      Display name for UI rendering
    </ResponseField>

    <ResponseField name="tagline" type="string">
      Short tagline or description
    </ResponseField>

    <ResponseField name="colorPrimary" type="string">
      Brand color in hex format (e.g., `#FBD109`)
    </ResponseField>

    <ResponseField name="logoUrl" type="string">
      Logo image URL (nullable)
    </ResponseField>

    <ResponseField name="status" type="string">
      Organization status (nullable)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="_meta" type="object">
  Request metadata

  <Expandable title="Metadata Properties">
    <ResponseField name="requestedAt" type="string">
      ISO 8601 timestamp of request processing
    </ResponseField>
  </Expandable>
</ResponseField>

## Rate Limit

<Info>
  **100 requests per minute** per IP address
</Info>

## Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.kash.bot/api/organizations/550e8400-e29b-41d4-a716-446655440000"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://app.kash.bot/api/organizations/550e8400-e29b-41d4-a716-446655440000'
  );
  const data = await response.json();
  console.log(`Organization: ${data.organization.displayName}`);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://app.kash.bot/api/organizations/550e8400-e29b-41d4-a716-446655440000'
  )
  data = response.json()
  print(f"Organization: {data['organization']['displayName']}")
  ```
</CodeGroup>

## Example Response

```json 200 - Success theme={null}
{
  "organization": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "acme-markets",
    "slug": "acme-markets",
    "displayName": "Acme Markets",
    "tagline": "Predict the future with Acme",
    "colorPrimary": "#4FC4FF",
    "logoUrl": "https://cdn.kash.bot/orgs/acme-logo.png",
    "status": "active"
  },
  "_meta": {
    "requestedAt": "2026-03-04T12:00:00Z"
  }
}
```

```json 404 - Not Found theme={null}
{
  "error": "Organization not found",
  "message": "No organization exists with ID: 550e8400-e29b-41d4-a716-446655440000",
  "code": "NOT_FOUND"
}
```

```json 429 - Rate Limit Exceeded theme={null}
{
  "error": "Too many requests",
  "message": "Rate limit of 100 requests per minute exceeded",
  "code": "RATE_LIMIT_EXCEEDED",
  "retryAfter": 45
}
```

## Response Headers

```
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1709553660000
Access-Control-Allow-Origin: *
```

## Common Use Cases

### Fetch branding for a white-label embed

```javascript theme={null}
async function applyOrgBranding(orgId) {
  const { organization } = await fetch(
    `https://app.kash.bot/api/organizations/${orgId}`
  ).then(r => r.json());

  document.documentElement.style.setProperty(
    '--brand-color', organization.colorPrimary
  );

  if (organization.logoUrl) {
    document.getElementById('logo').src = organization.logoUrl;
  }
}
```

## Related Endpoints

<CardGroup cols={2}>
  <Card title="Organization Partners" href="/developer-docs/public-embed-api/endpoints/organization-partners">
    List partners under this organization
  </Card>

  <Card title="Organization Threads" href="/developer-docs/public-embed-api/endpoints/organization-threads">
    List threads under this organization
  </Card>

  <Card title="GET /api/markets" href="/developer-docs/public-embed-api/endpoints/markets">
    Filter markets by organizationId
  </Card>
</CardGroup>