Communities V2
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.
Minimal Mode (minimal=true): Identical to v1, and subject to the same requirements: authentication is required, search is required with a minimum of 3 characters, and only search is honoured — onlyMemberOf, onlyWithActiveVoiceChat and roles are ignored. A request with minimal=true and no search term, or one shorter than 3 characters, is rejected with 400; without authentication, 401. Results exclude communities the caller is banned from, and total excludes them too.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
Search term to filter communities by name. Required when minimal=true (minimum 3 characters).
Filter to show only communities with active voice chats. Ignored when minimal=true.
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.
falseCommunities found
Invalid request
Unauthorized - authentication is required when minimal=true
Internal server error
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
}
}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.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
The unique identifier of the community.
Community found
Community not found
Internal server error
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
}
}
}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.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
The unique identifier of the community.
Members found
Unauthorized
Community not found
Internal server error
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-01-01T00:00:00.000Z",
"friendshipStatus": 1
}
],
"total": 1,
"limit": 1,
"offset": 1,
"page": 1,
"pages": 1
}
}Same as GET /v1/communities/{id}/bans but returns the banned member addresses (and friendship status) only, without any profile information.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
The unique identifier of the community.
Banned members found
Unauthorized - Signed Fetch required
Community not found
Internal server error
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-01-01T00:00:00.000Z",
"friendshipStatus": 1
}
],
"total": 1,
"limit": 1,
"offset": 1,
"page": 1,
"pages": 1
}
}Same as GET /v1/communities/{id}/requests but returns the requesting member addresses (and friendship status) only, without any profile information.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
The unique identifier of the community.
Community requests found
Unauthorized
Internal server error
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
}
}Same as GET /v1/members/{address}/requests but each request's community carries the owner address (no owner name) and mutual-friend addresses (string[]).
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
The address of the member.
Member requests found
Unauthorized
Internal server error
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
}
}Same as GET /v1/communities/{id}/posts but returns the post author addresses only, without any profile information.
Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.
The unique identifier of the community.
Posts found
Unauthorized
Community not found
Internal server error
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-01-01T00:00:00.000Z",
"likesCount": 1,
"isLikedByUser": true
}
],
"total": 1
}
}Last updated