Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Lists

Manage user favorites lists (curated collections)

Get picks from a favorites list

get
/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
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
idstringRequired

Pick ID

itemIdstringRequired

Item ID

listIdstringRequired

List ID

userstringRequired

User address

createdAtstring · date-timeOptional

Pick creation timestamp

get/v1/lists/{id}/picks
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-01T00:00:00.000Z"
  }
]

Add item to favorites list

post
/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
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
itemIdstringRequired

Item ID

Responses
201

Pick added successfully

application/json
idstringRequired

Pick ID

itemIdstringRequired

Item ID

listIdstringRequired

List ID

userstringRequired

User address

createdAtstring · date-timeOptional

Pick creation timestamp

post/v1/lists/{id}/picks
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-01T00:00:00.000Z"
}

Remove item from favorites list

delete
/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
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
successbooleanOptional
delete/v1/lists/{id}/picks/{itemId}
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
/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
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
idstringRequired

List ID

namestringRequired

List name

descriptionstringOptional

List description

ownerstringRequired

List owner

isPublicbooleanRequired

Whether list is public

itemCountnumberRequired

Number of items in list

createdAtstring · date-timeOptional

List creation timestamp

get/v1/lists/{id}
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-01T00:00:00.000Z"
}

Update favorites list

put
/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
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
namestringRequired

List name

descriptionstringOptional

List description

isPublicbooleanRequired

Whether list should be public

Responses
200

List updated successfully

application/json
idstringRequired

List ID

namestringRequired

List name

descriptionstringOptional

List description

ownerstringRequired

List owner

isPublicbooleanRequired

Whether list is public

itemCountnumberRequired

Number of items in list

createdAtstring · date-timeOptional

List creation timestamp

put/v1/lists/{id}
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-01T00:00:00.000Z"
}

Delete favorites list

delete
/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
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
successbooleanOptional
delete/v1/lists/{id}
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
/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
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
idstringRequired

List ID

namestringRequired

List name

descriptionstringOptional

List description

ownerstringRequired

List owner

isPublicbooleanRequired

Whether list is public

itemCountnumberRequired

Number of items in list

createdAtstring · date-timeOptional

List creation timestamp

get/v1/lists
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-01T00:00:00.000Z"
  }
]

Create new favorites list

post
/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
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
namestringRequired

List name

descriptionstringOptional

List description

isPublicbooleanRequired

Whether list should be public

Responses
201

List created successfully

application/json
idstringRequired

List ID

namestringRequired

List name

descriptionstringOptional

List description

ownerstringRequired

List owner

isPublicbooleanRequired

Whether list is public

itemCountnumberRequired

Number of items in list

createdAtstring · date-timeOptional

List creation timestamp

post/v1/lists
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-01T00:00:00.000Z"
}

Grant access to private list

post
/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
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
userAddressstringRequired

User address to grant access to

permissionsstring[]Required

List of permissions

Responses
200

Access granted successfully

application/json
successbooleanOptional
post/v1/lists/{id}/access
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
/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
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
userAddressstringRequired

User address to revoke access from

Responses
200

Access revoked successfully

application/json
successbooleanOptional
delete/v1/lists/{id}/access
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
}
PreviousVolume
NextPicks

Last updated