Collections
Wearable and emote collection management
Returns collections with filtering and pagination (committee members only for full access)
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Search query
Page number for pagination
1Number of items per page
20List of collections
Unauthorized - authentication required or insufficient permissions
GET /v1/collections HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*
{
"ok": true,
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"eth_address": "text",
"salt": "text",
"contract_address": "text",
"urn": "text",
"is_published": true,
"is_approved": true,
"minters": [
"text"
],
"managers": [
"text"
],
"forum_link": "text",
"forum_id": 1,
"lock": "2026-01-01T00:00:00.000Z",
"reviewed_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
]
}Returns collections for a specific address
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Page number for pagination
1Number of items per page
20List of collections
Unauthorized - authentication required or insufficient permissions
GET /v1/{address}/collections HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*
{
"ok": true,
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"eth_address": "text",
"salt": "text",
"contract_address": "text",
"urn": "text",
"is_published": true,
"is_approved": true,
"minters": [
"text"
],
"managers": [
"text"
],
"forum_link": "text",
"forum_id": 1,
"lock": "2026-01-01T00:00:00.000Z",
"reviewed_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
]
}Returns a collection by ID
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Collection UUID
Collection details
Unauthorized - authentication required or insufficient permissions
Resource not found
GET /v1/collections/{id} HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*
{
"ok": true,
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"eth_address": "text",
"salt": "text",
"contract_address": "text",
"urn": "text",
"is_published": true,
"is_approved": true,
"minters": [
"text"
],
"managers": [
"text"
],
"forum_link": "text",
"forum_id": 1,
"lock": "2026-01-01T00:00:00.000Z",
"reviewed_at": "2026-01-01T00:00:00.000Z",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
}Creates a new collection or updates an existing one
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Collection UUID
Collection created/updated successfully
No content
Bad request - invalid input
Unauthorized - authentication required or insufficient permissions
Conflict - resource already exists or is in an invalid state
Resource is locked and cannot be modified
PUT /v1/collections/{id} HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 72
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"urn": "text"
}No content
Deletes a collection
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Collection UUID
Collection deleted successfully
No content
Unauthorized - authentication required or insufficient permissions
Conflict - resource already exists or is in an invalid state
Resource is locked and cannot be modified
DELETE /v1/collections/{id} HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*
No content
Publishes a collection to the blockchain
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Collection UUID
Collection published successfully
No content
Bad request - invalid input
Unauthorized - authentication required or insufficient permissions
Conflict - resource already exists or is in an invalid state
POST /v1/collections/{id}/publish HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 72
{
"itemIds": [
"text"
],
"cheque": {
"qty": 1,
"salt": "text",
"signature": "text"
}
}No content
Locks a collection until publication
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Collection UUID
Collection locked successfully
Unauthorized - authentication required or insufficient permissions
Resource not found
Internal server error
POST /v1/collections/{id}/lock HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*
{
"ok": true,
"data": "2026-01-01T00:00:00.000Z"
}Records Terms of Service acceptance for collection publication
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Collection UUID
TOS recorded successfully
No content
Unauthorized - authentication required or insufficient permissions
Resource not found
Internal server error
POST /v1/collections/{id}/tos HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 77
{
"email": "[email protected]",
"event": "publish_collection_tos",
"hashes": [
"text"
]
}No content
Returns data needed to approve a third-party collection
Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.
Collection UUID
Approval data
Unauthorized - authentication required or insufficient permissions
Resource not found
Conflict - resource already exists or is in an invalid state
Internal server error
GET /v1/collections/{id}/approvalData HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*
{
"cheque": {
"qty": 1,
"salt": "text",
"signature": "text"
},
"content_hashes": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"chequeWasConsumed": true,
"root": "text"
}Returns collection contract addresses with filtering
Page number for pagination
1Number of items per page
20List of addresses
No content
GET /v1/addresses HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*
List of addresses
No content
Last updated