---
title: "List communities (v2, address-only)"
method: GET
path: "/v2/communities"
tags: ["Communities v2"]
---

# List communities (v2, address-only)

`GET /v2/communities`

Same as GET /v1/communities but the response contains only addresses: the owner
address (no owner name) and mutual-friend addresses (string[]) instead of friend
profiles. The `minimal` search branch is unchanged (it already returns no profile
information).

## Query parameters

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

## Response `200`

Communities found

- object
  - `data` object, required
    - `results` object[], required
      - `id` string, required
      - `name` string, required
      - `description` string
      - `ownerAddress` string — ETH Address of the community owner
      - `privacy` 'public' | 'private', required
      - `visibility` 'all' | 'unlisted'
      - `active` boolean
      - `membersCount` integer, required
      - `thumbnails` object — Map of thumbnail URLs by size/type
      - `friends` string[] — Addresses of friends who are members of this community. Only present when the user is signed in.
      - `role` 'owner' | 'moderator' | 'member' | 'none' — The role of the user in the community. 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

## Other responses

- `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)