Items

Wearable and emote item management

Get all items

get

/items

Returns all items (committee members only)

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Responses

200

List of items

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

get

/items

GET /v1/items 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",
      "urn": "text",
      "name": "text",
      "description": "text",
      "thumbnail": "text",
      "video": "text",
      "eth_address": "text",
      "collection_id": "123e4567-e89b-12d3-a456-426614174000",
      "blockchain_item_id": "text",
      "price": "text",
      "beneficiary": "text",
      "rarity": "common",
      "type": "wearable",
      "data": {},
      "metrics": {},
      "utility": "text",
      "contents": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappings": {},
      "is_published": true,
      "is_approved": true,
      "in_catalyst": true,
      "total_supply": 1,
      "content_hash": "text",
      "created_at": "2026-01-20T17:51:46.277Z",
      "updated_at": "2026-01-20T17:51:46.277Z"
    }
  ]
}

Get items by address

get

/{address}/items

Returns items for a specific address

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

addressstringRequired

Query parameters

collectionIdstringOptional

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

Responses

200

List of items

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

get

/{address}/items

GET /v1/{address}/items 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",
      "urn": "text",
      "name": "text",
      "description": "text",
      "thumbnail": "text",
      "video": "text",
      "eth_address": "text",
      "collection_id": "123e4567-e89b-12d3-a456-426614174000",
      "blockchain_item_id": "text",
      "price": "text",
      "beneficiary": "text",
      "rarity": "common",
      "type": "wearable",
      "data": {},
      "metrics": {},
      "utility": "text",
      "contents": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappings": {},
      "is_published": true,
      "is_approved": true,
      "in_catalyst": true,
      "total_supply": 1,
      "content_hash": "text",
      "created_at": "2026-01-20T17:51:46.277Z",
      "updated_at": "2026-01-20T17:51:46.277Z"
    }
  ]
}

Get an item

get

/items/{id}

Returns an item by ID

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idstring · uuidRequired

Item UUID

Responses

200

Item details

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

500

Internal server error

application/json

get

/items/{id}

GET /v1/items/{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",
    "urn": "text",
    "name": "text",
    "description": "text",
    "thumbnail": "text",
    "video": "text",
    "eth_address": "text",
    "collection_id": "123e4567-e89b-12d3-a456-426614174000",
    "blockchain_item_id": "text",
    "price": "text",
    "beneficiary": "text",
    "rarity": "common",
    "type": "wearable",
    "data": {},
    "metrics": {},
    "utility": "text",
    "contents": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "mappings": {},
    "is_published": true,
    "is_approved": true,
    "in_catalyst": true,
    "total_supply": 1,
    "content_hash": "text",
    "created_at": "2026-01-20T17:51:46.277Z",
    "updated_at": "2026-01-20T17:51:46.277Z"
  }
}

Create or update an item

put

/items/{id}

Creates a new item or updates an existing one (by ID or URN)

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idone ofRequired

Item UUID or URN

string · uuidOptional

Body

idstring · uuidRequired

urnstringOptional

namestringRequired

descriptionstringRequired

collection_idstring · uuidOptional

raritystringRequired

typestring · enumRequiredPossible values:

dataobjectRequired

contentsobjectRequired

utilitystringOptional

mappingsobjectOptional

Responses

200

Item created/updated successfully

No content

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

409

Conflict - resource already exists or is in an invalid state

application/json

423

Resource is locked and cannot be modified

application/json

put

/items/{id}

PUT /v1/items/{id} HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 237

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "urn": "text",
  "name": "text",
  "description": "text",
  "collection_id": "123e4567-e89b-12d3-a456-426614174000",
  "rarity": "text",
  "type": "wearable",
  "data": {},
  "contents": {},
  "utility": "text",
  "mappings": {}
}

No content

Delete an item

delete

/items/{id}

Deletes an item

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idstring · uuidRequired

Item UUID

Responses

200

Item deleted successfully

No content

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

409

Conflict - resource already exists or is in an invalid state

application/json

423

Resource is locked and cannot be modified

application/json

500

Internal server error

application/json

delete

/items/{id}

DELETE /v1/items/{id} HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Accept: */*

No content

Get collection items

get

/collections/{id}/items

Returns items for a specific collection

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idstring · uuidRequired

Collection UUID

Query parameters

statusstring · enumOptionalPossible values:

syncedstringOptional

mappingStatusstring · enumOptionalPossible values:

namestringOptional

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20

Responses

200

List of items

application/json

400

Bad request - invalid input

application/json

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

get

/collections/{id}/items

GET /v1/collections/{id}/items 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",
      "urn": "text",
      "name": "text",
      "description": "text",
      "thumbnail": "text",
      "video": "text",
      "eth_address": "text",
      "collection_id": "123e4567-e89b-12d3-a456-426614174000",
      "blockchain_item_id": "text",
      "price": "text",
      "beneficiary": "text",
      "rarity": "common",
      "type": "wearable",
      "data": {},
      "metrics": {},
      "utility": "text",
      "contents": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappings": {},
      "is_published": true,
      "is_approved": true,
      "in_catalyst": true,
      "total_supply": 1,
      "content_hash": "text",
      "created_at": "2026-01-20T17:51:46.277Z",
      "updated_at": "2026-01-20T17:51:46.277Z"
    }
  ]
}

Upload item files

post

/items/{id}/files

Uploads content files for an item

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idstring · uuidRequired

Item UUID

Body

objectOptional

Responses

200

Files uploaded successfully

No content

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

post

/items/{id}/files

POST /v1/items/{id}/files HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 2

{}

No content

Upload item video

post

/items/{id}/videos

Uploads a video file for an item (max 250MB)

Authorizations

X-Identity-Auth-Chain-*stringRequired

Signed fetch authentication using Decentraland's ADR-44 specification. Multiple headers are used to provide the authentication chain.

Path parameters

idstring · uuidRequired

Item UUID

Body

objectOptional

Responses

200

Video uploaded successfully

No content

401

Unauthorized - authentication required or insufficient permissions

application/json

404

Resource not found

application/json

post

/items/{id}/videos

POST /v1/items/{id}/videos HTTP/1.1
Host: builder-api.decentraland.org
X-Identity-Auth-Chain-*: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 2

{}

No content

Get item contents

get

/items/{collectionAddress}/{itemId}/contents

Returns item contents by contract address and item ID

Path parameters

collectionAddressstringRequired

itemIdstringRequired

Responses

200

Item contents

application/json

404

Resource not found

application/json

500

Internal server error

application/json

get

/items/{collectionAddress}/{itemId}/contents

GET /v1/items/{collectionAddress}/{itemId}/contents HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Get item utility

get

/published-collections/{address}/items/{id}/utility

Returns the utility field for a published item

Path parameters

addressstringRequired

idstringRequired

Responses

200

Item utility

application/json

404

Resource not found

application/json

get

/published-collections/{address}/items/{id}/utility

GET /v1/published-collections/{address}/items/{id}/utility HTTP/1.1
Host: builder-api.decentraland.org
Accept: */*

{
  "utility": "text"
}

PreviousCollections NextCurations

Last updated 21 days ago

hashtagGet all items

hashtagGet items by address

hashtagGet an item

hashtagCreate or update an item

hashtagDelete an item

hashtagGet collection items

hashtagUpload item files

hashtagUpload item video

hashtagGet item contents

hashtagGet item utility

Get all items

Get items by address

Get an item

Create or update an item

Delete an item

Get collection items

Upload item files

Upload item video

Get item contents

Get item utility