---
title: "Get community"
method: GET
path: "/v1/communities/{communityId}"
tags: ["Communities"]
---

# Get community

`GET /v1/communities/{communityId}`

## Request

- Base URL: `https://api.subo.ai`
- URL: `https://api.subo.ai/v1/communities/{communityId}`
- Auth: API key in header `X-API-Key`

Get full community details including identity fields and grouped settings (general, defaults, rewards, experience, usage). Pass `?expand=platforms.discord` to also include Discord-specific settings (channels, roles, bot info). Discord settings are excluded by default because they require additional database queries.

## Path parameters

- `communityId` string, required

## Query parameters

- `expand` 'platforms.discord'

## Response `200`

Community details with grouped settings

## Other responses

- `401`: Invalid or missing API key
- `403`: Forbidden — the key or user lacks permission for this resource or operation
- `404`: Resource not found
- `429`: Rate limit exceeded — wait `retry_after` seconds before retrying. The same value appears in the `Retry-After` header.

---

[API](https://skmtc.dev/subo/apis/subo-api.md) · [All operations](https://skmtc.dev/subo/apis/subo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/subo/apis/subo-api/revisions/12eab2ae4505?raw)