---
title: "List communities"
method: GET
path: "/v1/communities"
tags: ["Communities"]
---

# List communities

`GET /v1/communities`

Lists all communities with full details, or performs a fast community search with minimal data.
This endpoint has optional Signed Fetch authentication.
When signed, it includes properties related to the authenticated user in its response.
This endpoint excludes unlisted communities from results. Use direct community access (GET `/v1/communities/{id}`) to retrieve unlisted communities.

**Minimal Mode (minimal=true):**
When `minimal=true` is set, authentication is required and only the `search` parameter is used:
- Returns community `id`, `name`, `membersCount`, and `privacy` for fast lookups
- Requires `search` parameter with minimum 3 characters
- Maximum 50 results per request
- Supports pagination with `limit` and `offset` parameters
- Other filter parameters are ignored

**Visibility Rules (Minimal Mode):**
- Public and Private communities: searchable by anyone
- Unlisted communities: only searchable by their members

**Search Behavior (Minimal Mode):**
- Matches community names starting with the search term
- Also matches words in the middle of the name (after a space)

## Query parameters

- `limit` integer
- `offset` integer
- `search` string
- `minimal` boolean
- `onlyMemberOf` boolean
- `onlyWithActiveVoiceChat` boolean
- `roles` string[]

## Response `200`

Communities found

- union
  - object
    - `data` object, required
      - `results` object[], required
        - `id` string, required
        - `name` string, required
        - `description` string, required
        - `ownerAddress` string, required
        - `ownerName` string — Display name of the community owner
        - `privacy` 'public' | 'private', required
        - `visibility` 'all' | 'unlisted', required — Community visibility setting (all = listed, unlisted = hidden from general listings)
        - `active` boolean, required
        - `membersCount` integer, required
        - `thumbnails` object — Map of thumbnail URLs by size/type
        - `friends` object[] — Array of friends who are members of this community. This is only present when the user is signed in.
        - `role` 'owner' | 'moderator' | 'member' | 'none' — The role of the user in the community. This is only present when the user is signed in.
        - `voiceChatStatus` object, nullable — Voice chat status for the community (null if no active voice chat)
          - `isActive` boolean
          - `participantCount` integer
          - `moderatorCount` integer
      - `total` integer, required — Total number of items
      - `limit` integer, required — Number of items per page
      - `offset` integer, required — Number of items skipped
      - `page` integer — Current page number (1-indexed)
      - `pages` integer — Total number of pages
  - object
    - `data` object, required
      - `results` object[], required — List of communities matching the search query with minimal data
        - `id` string, uuid, required — Unique identifier of the community
        - `name` string, required — Name of the community
        - `membersCount` integer, required — Number of members in the community
        - `privacy` 'public' | 'private', required — Community privacy setting
      - `total` integer, required — Total number of items
      - `limit` integer, required — Number of items per page
      - `offset` integer, required — Number of items skipped
      - `page` integer — Current page number (1-indexed)
      - `pages` integer — Total number of pages

## Other responses

- `400` — Invalid request
- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)