Communities V2

List communities (v2, address-only)

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/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).

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Query parameters

limitintegerOptional

offsetintegerOptional

searchstringOptional

onlyMemberOfbooleanOptional

onlyWithActiveVoiceChatbooleanOptional

Filter to show only communities with active voice chats. Ignored when minimal=true.

minimalbooleanOptional

When true, returns only id, name, membersCount, and privacy for fast lookups. Requires authentication and a search parameter with at least 3 characters. Supports pagination with limit (max 50) and offset. Other filters (onlyMemberOf, onlyWithActiveVoiceChat, roles) are ignored.

Default: false

Responses

200

Communities found

application/json

500

Internal server error

application/json

get/v2/communities

HTTPcURLJavaScriptPython

GET /v2/communities HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "name": "text",
        "description": "text",
        "ownerAddress": "text",
        "privacy": "public",
        "visibility": "all",
        "active": true,
        "membersCount": 1,
        "thumbnails": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "friends": [
          "text"
        ],
        "role": "owner",
        "voiceChatStatus": {
          "isActive": true,
          "participantCount": 1,
          "moderatorCount": 1
        }
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Get community by ID (v2, address-only)

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v2/communities/{id}

Same as GET /v1/communities/{id} but the response contains only the owner address (no owner name). Never fails when the owner profile cannot be resolved.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Responses

200

Community found

application/json

404

Community not found

application/json

500

Internal server error

application/json

get/v2/communities/{id}

HTTPcURLJavaScriptPython

GET /v2/communities/{id} HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "id": "text",
    "name": "text",
    "description": "text",
    "ownerAddress": "text",
    "privacy": "public",
    "visibility": "all",
    "active": true,
    "membersCount": 1,
    "role": "owner",
    "thumbnails": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "voiceChatStatus": {
      "isActive": true,
      "participantCount": 1,
      "moderatorCount": 1
    }
  }
}

List community members (v2, address-only)

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v2/communities/{id}/members

Same as GET /v1/communities/{id}/members but returns the member addresses (and friendship status) only, without any profile information. Members whose profile is missing are NOT dropped.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

limitintegerOptional

offsetintegerOptional

onlyOnlinebooleanOptional

Responses

200

Members found

application/json

401

Unauthorized

application/json

404

Community not found

application/json

500

Internal server error

application/json

get/v2/communities/{id}/members

HTTPcURLJavaScriptPython

GET /v2/communities/{id}/members HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "communityId": "text",
        "memberAddress": "text",
        "role": "owner",
        "joinedAt": "2026-07-10T19:16:36.112Z",
        "friendshipStatus": 1
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

List banned members (v2, address-only)

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v2/communities/{id}/bans

Same as GET /v1/communities/{id}/bans but returns the banned member addresses (and friendship status) only, without any profile information.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

limitintegerOptional

offsetintegerOptional

Responses

200

Banned members found

application/json

401

Unauthorized - Signed Fetch required

application/json

404

Community not found

application/json

500

Internal server error

application/json

get/v2/communities/{id}/bans

HTTPcURLJavaScriptPython

GET /v2/communities/{id}/bans HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "communityId": "text",
        "memberAddress": "text",
        "bannedAt": "2026-07-10T19:16:36.112Z",
        "friendshipStatus": 1
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Get community requests (v2, address-only)

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v2/communities/{id}/requests

Same as GET /v1/communities/{id}/requests but returns the requesting member addresses (and friendship status) only, without any profile information.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

typestring · enumOptionalPossible values:

limitintegerOptional

offsetintegerOptional

Responses

200

Community requests found

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

get/v2/communities/{id}/requests

HTTPcURLJavaScriptPython

GET /v2/communities/{id}/requests HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "communityId": "text",
        "memberAddress": "text",
        "type": "invite",
        "status": "pending",
        "friendshipStatus": 1
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Get member requests (v2, address-only)

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v2/members/{address}/requests

Same as GET /v1/members/{address}/requests but each request's community carries the owner address (no owner name) and mutual-friend addresses (string[]).

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

addressstringRequired

The address of the member.

Query parameters

typestring · enumOptionalPossible values:

limitintegerOptional

offsetintegerOptional

Responses

200

Member requests found

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

get/v2/members/{address}/requests

HTTPcURLJavaScriptPython

GET /v2/members/{address}/requests HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "id": "text",
        "communityId": "text",
        "memberAddress": "text",
        "type": "invite",
        "status": "pending",
        "name": "text",
        "description": "text",
        "ownerAddress": "text",
        "privacy": "public",
        "membersCount": 1,
        "role": "owner",
        "active": true,
        "visibility": "all",
        "thumbnails": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "friends": [
          "text"
        ],
        "voiceChatStatus": {
          "isActive": true,
          "participantCount": 1,
          "moderatorCount": 1
        }
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Get community posts (v2, address-only)

get

https://social-api.decentraland.orghttps://social-api.decentraland.zone

/v2/communities/{id}/posts

Same as GET /v1/communities/{id}/posts but returns the post author addresses only, without any profile information.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Path parameters

idstringRequired

The unique identifier of the community.

Query parameters

limitintegerOptional

offsetintegerOptional

Responses

200

Posts found

application/json

401

Unauthorized

application/json

404

Community not found

application/json

500

Internal server error

application/json

get/v2/communities/{id}/posts

HTTPcURLJavaScriptPython

GET /v2/communities/{id}/posts HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "posts": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "communityId": "123e4567-e89b-12d3-a456-426614174000",
        "authorAddress": "text",
        "content": "text",
        "createdAt": "2026-07-10T19:16:36.112Z",
        "likesCount": 1,
        "isLikedByUser": true
      }
    ],
    "total": 1
  }
}