Districts

Endpoints for querying information about districts in Genesis City, including contributions made by community members.

Get all districts

get

/v2/districts

Returns a list of all districts in Genesis City. Districts are special areas with unique themes and community-driven development.

Responses

200

List of all districts

application/json

get/v2/districts

GET /v2/districts HTTP/1.1
Host: api.decentraland.org
Accept: */*

200

List of all districts

{
  "ok": true,
  "data": [
    {
      "id": "aetherian-project",
      "name": "Aetherian Project",
      "description": "A district focused on art and culture",
      "parcels": [
        "23,-23"
      ],
      "totalParcels": 42
    }
  ]
}

Get a specific district by ID

get

/v2/districts/{id}

Returns detailed information about a specific district, including its name, description, and all parcels that belong to it.

Path parameters

idstringRequired

District ID

Example: aetherian-project

Responses

200

District information

application/json

404

District not found

text/plain

get/v2/districts/{id}

GET /v2/districts/{id} HTTP/1.1
Host: api.decentraland.org
Accept: */*

{
  "ok": true,
  "data": {
    "id": "aetherian-project",
    "name": "Aetherian Project",
    "description": "A district focused on art and culture",
    "parcels": [
      "23,-23"
    ],
    "totalParcels": 42
  }
}

Get contributions by address

get

/v2/addresses/{address}/contributions

Returns a list of all district contributions made by a specific Ethereum address. Contributions represent parcels that were contributed during the district allocation phase.

Path parameters

addressstringRequired

Ethereum address

Example: 0x1234567890abcdef1234567890abcdef12345678

Responses

200

List of contributions

application/json

get/v2/addresses/{address}/contributions

GET /v2/addresses/{address}/contributions HTTP/1.1
Host: api.decentraland.org
Accept: */*

200

List of contributions

{
  "ok": true,
  "data": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "districtId": "aetherian-project",
      "totalParcels": 5
    }
  ]
}