Lists

Manage user favorites lists (curated collections)

Get picks from a favorites list

get

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

/v1/lists/{id}/picks

Retrieves all items (picks) that have been added to a specific favorites list. Lists are user-curated collections of marketplace items.

Authentication is optional but recommended to access private lists or user-specific data.

Authorizations

SignedFetch

AuthorizationstringOptional

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

idstringRequired

Unique identifier of the favorites list

Responses

200

List picks

application/json

get

/v1/lists/{id}/picks

HTTPcURLJavaScriptPython

GET /v1/lists/{id}/picks HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List picks

[
  {
    "id": "text",
    "itemId": "text",
    "listId": "text",
    "user": "text",
    "createdAt": "2026-01-21T01:40:55.636Z"
  }
]

Add item to favorites list

post

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

/v1/lists/{id}/picks

Adds an item (pick) to a user's favorites list.

Authentication Required: User must be authenticated and authorized to modify the list. Only list owners and users with granted access can add items.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

idstringRequired

Unique identifier of the favorites list

Body

application/json

itemIdstringRequired

Item ID

Responses

201

Pick added successfully

application/json

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

post

/v1/lists/{id}/picks

HTTPcURLJavaScriptPython

POST /v1/lists/{id}/picks HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "itemId": "text"
}

{
  "id": "text",
  "itemId": "text",
  "listId": "text",
  "user": "text",
  "createdAt": "2026-01-21T01:40:55.636Z"
}

Remove item from favorites list

delete

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

/v1/lists/{id}/picks/{itemId}

Removes a specific item (pick) from a favorites list.

Authentication Required: User must be authenticated and authorized to modify the list. Only list owners and users with granted access can remove items.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

idstringRequired

Unique identifier of the favorites list

itemIdstringRequired

Unique identifier of the item to remove

Responses

200

Pick removed successfully

application/json

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

delete

/v1/lists/{id}/picks/{itemId}

HTTPcURLJavaScriptPython

DELETE /v1/lists/{id}/picks/{itemId} HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

Get favorites list details

get

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

/v1/lists/{id}

Retrieves detailed information about a specific favorites list.

Returns:

• List name and description

• Owner information

• Privacy settings (public/private)

• Item count

• Creation and update timestamps

Authentication may be required for private lists depending on access permissions.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

idstringRequired

Unique identifier of the favorites list

Responses

200

List details

application/json

404

List not found

application/json

get

/v1/lists/{id}

HTTPcURLJavaScriptPython

GET /v1/lists/{id} HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text",
  "description": "text",
  "owner": "text",
  "isPublic": true,
  "itemCount": 1,
  "createdAt": "2026-01-21T01:40:55.636Z"
}

Update favorites list

put

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

/v1/lists/{id}

Updates an existing favorites list's properties.

Authentication Required: Only the list owner can update list details.

Updatable fields:

• List name

• Description

• Privacy settings (public/private)

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

idstringRequired

Unique identifier of the favorites list to update

Body

application/json

namestringRequired

List name

descriptionstringOptional

List description

isPublicbooleanRequired

Whether list should be public

Responses

200

List updated successfully

application/json

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

404

List not found

application/json

put

/v1/lists/{id}

HTTPcURLJavaScriptPython

PUT /v1/lists/{id} HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "name": "text",
  "description": "text",
  "isPublic": true
}

{
  "id": "text",
  "name": "text",
  "description": "text",
  "owner": "text",
  "isPublic": true,
  "itemCount": 1,
  "createdAt": "2026-01-21T01:40:55.636Z"
}

Delete favorites list

delete

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

/v1/lists/{id}

Permanently deletes a favorites list and all its picks.

Authentication Required: Only the list owner can delete the list.

Warning: This action is irreversible. All items in the list will be removed.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

idstringRequired

Unique identifier of the favorites list to delete

Responses

200

List deleted successfully

application/json

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

404

List not found

application/json

delete

/v1/lists/{id}

HTTPcURLJavaScriptPython

DELETE /v1/lists/{id} HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

Get user's favorites lists

get

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

/v1/lists

Retrieves all favorites lists owned by the authenticated user.

Authentication Required: User must be authenticated to view their lists.

Returns both public and private lists owned by the user, including:

• List metadata (name, description, privacy settings)

• Item counts

• Creation and update timestamps

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Responses

200

User lists

application/json

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

get

/v1/lists

HTTPcURLJavaScriptPython

GET /v1/lists HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "description": "text",
    "owner": "text",
    "isPublic": true,
    "itemCount": 1,
    "createdAt": "2026-01-21T01:40:55.636Z"
  }
]

Create new favorites list

post

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

/v1/lists

Creates a new favorites list for the authenticated user.

Authentication Required: User must be authenticated.

When creating a list, specify:

• List name (required)

• Description (optional)

• Privacy setting: public or private (required)

Public lists can be viewed by anyone, while private lists are only accessible to the owner and users who have been granted explicit access.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Body

application/json

namestringRequired

List name

descriptionstringOptional

List description

isPublicbooleanRequired

Whether list should be public

Responses

201

List created successfully

application/json

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

post

/v1/lists

HTTPcURLJavaScriptPython

POST /v1/lists HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "name": "text",
  "description": "text",
  "isPublic": true
}

{
  "id": "text",
  "name": "text",
  "description": "text",
  "owner": "text",
  "isPublic": true,
  "itemCount": 1,
  "createdAt": "2026-01-21T01:40:55.636Z"
}

Grant access to private list

post

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

/v1/lists/{id}/access

Grants a user access to a private favorites list.

Authentication Required: Only the list owner can grant access.

Use this endpoint to share private lists with specific users by providing their wallet address and desired permissions. This allows collaborative list management without making the list public.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

idstringRequired

Unique identifier of the favorites list

Body

application/json

userAddressstringRequired

User address to grant access to

permissionsstring[]Required

List of permissions

Responses

200

Access granted successfully

application/json

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

404

List not found

application/json

post

/v1/lists/{id}/access

HTTPcURLJavaScriptPython

POST /v1/lists/{id}/access HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "userAddress": "text",
  "permissions": [
    "text"
  ]
}

{
  "success": true
}

Revoke access from private list

delete

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

/v1/lists/{id}/access

Revokes a user's access to a private favorites list.

Authentication Required: Only the list owner can revoke access.

After revocation, the specified user will no longer be able to view or modify the private list. Use this endpoint to manage access control for collaborative lists.

Authorizations

SignedFetch

AuthorizationstringRequired

Signed fetch authentication using decentraland-crypto-middleware with metadata validation (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters

idstringRequired

Unique identifier of the favorites list

Body

application/json

userAddressstringRequired

User address to revoke access from

Responses

200

Access revoked successfully

application/json

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

404

List not found

application/json

delete

/v1/lists/{id}/access

HTTPcURLJavaScriptPython

DELETE /v1/lists/{id}/access HTTP/1.1
Host: marketplace-api.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "userAddress": "text"
}

{
  "success": true
}