Entities

Entity management and asset bundle queries

Get active entities by pointers

post

https://asset-bundle-registry.decentraland.org

/entities/active

Returns the currently active (ready-to-use) entities for the given pointers. This is the primary endpoint for clients to query which asset bundles are available for display.

Pointers are unique identifiers for content locations:

• For scenes: coordinates like "-53,71" or "-100,-50"

• For wearables: URNs like "urn:decentraland:matic:collections-v2:0x..."

The response includes entities with their associated asset bundle content that are ready for use. If new content is currently being processed for a pointer, this endpoint will return the previous successfully converted version, ensuring clients always have something to render.

Body

application/json

pointersstring[]Required

List of pointers to query for active entities. Pointers are unique identifiers for content locations:

• Scene coordinates (e.g., "-53,71", "0,0")
• Wearable URNs (e.g., "urn:decentraland:matic:collections-v2:0xabc...")

Responses

200

List of active entities

application/json

Represents a Decentraland entity (scene, wearable, etc.) with its converted asset bundle information. This is the primary data structure returned when querying for active entities.

idstringRequired

Unique entity identifier (content identifier/CID from Catalyst)

typestringRequired

Entity type indicating the kind of content:

• scene: A Decentraland scene/parcel
• wearable: An avatar wearable item
• profile: A user profile
• emote: An avatar emote/animation

pointersstring[]Required

List of pointers where this entity is active. For scenes, these are coordinates (e.g., "-53,71"). For wearables, these are URNs identifying the item.

timestampnumberRequired

Unix timestamp (milliseconds) indicating when this entity was deployed to Catalyst

400

Bad request

application/json

post/entities/active

HTTPcURLJavaScriptPython

POST /entities/active HTTP/1.1
Host: asset-bundle-registry.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "pointers": [
    "text"
  ]
}

[
  {
    "id": "text",
    "type": "text",
    "pointers": [
      "text"
    ],
    "timestamp": 1,
    "content": [
      {
        "file": "text",
        "hash": "text"
      }
    ],
    "metadata": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  }
]

Get entity status by ID

get

https://asset-bundle-registry.decentraland.org

/entities/status/{id}

Returns the current processing status of a specific entity by its ID (typically a content identifier/CID).

Use this endpoint to check whether an entity has been successfully converted to an asset bundle, is currently being processed, or is inactive.

Status values:

• active: Entity has been successfully converted and is ready for use

• processing: Entity is currently being converted by the Asset Bundle Converter

• inactive: Entity conversion failed or the entity is no longer active

Path parameters

idstringRequired

Entity ID (content identifier/CID)

Responses

200

Entity status

application/json

Represents the current processing and availability status of an entity's asset bundle conversion

entityIdstringRequired

Unique entity identifier (content identifier/CID)

completebooleanRequired

Whether asset bundles are fully converted for all required platforms (Windows and Mac)

catalyststring · enumRequired

Status of the entity in Catalyst (always 'complete' if entity exists in registry)

Possible values:

404

Entity not found

application/json

get/entities/status/{id}

HTTPcURLJavaScriptPython

GET /entities/status/{id} HTTP/1.1
Host: asset-bundle-registry.decentraland.org
Accept: */*

{
  "entityId": "text",
  "complete": true,
  "catalyst": "pending",
  "assetBundles": {
    "mac": "pending",
    "windows": "pending"
  },
  "lods": {
    "mac": "pending",
    "windows": "pending"
  }
}

Get multiple entities status

get

https://asset-bundle-registry.decentraland.org

/entities/status

Returns the processing status of multiple entities in a single request. This endpoint requires authenticated access via Decentraland's signed fetch mechanism.

Useful for batch checking the conversion status of multiple pieces of content (scenes, wearables, etc.) to determine which are ready for use and which are still being processed.

Authorizations

SignedFetch

AuthorizationstringRequired

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

Query parameters

idsstring[]Required

Comma-separated list of entity IDs (content identifiers/CIDs)

Responses

200

List of entity statuses

application/json

Represents the current processing and availability status of an entity's asset bundle conversion

entityIdstringRequired

Unique entity identifier (content identifier/CID)

completebooleanRequired

Whether asset bundles are fully converted for all required platforms (Windows and Mac)

catalyststring · enumRequired

Status of the entity in Catalyst (always 'complete' if entity exists in registry)

Possible values:

401

Unauthorized - invalid signed fetch

application/json

403

Forbidden - invalid metadata

application/json

get/entities/status

HTTPcURLJavaScriptPython

GET /entities/status?ids=text HTTP/1.1
Host: asset-bundle-registry.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "entityId": "text",
    "complete": true,
    "catalyst": "pending",
    "assetBundles": {
      "mac": "pending",
      "windows": "pending"
    },
    "lods": {
      "mac": "pending",
      "windows": "pending"
    }
  }
]

Get entity versions by pointers

post

https://asset-bundle-registry.decentraland.org

/entities/versions

Returns the version information and bundle status for entities at the given pointers. This endpoint is useful for checking which asset bundle versions are available for specific content locations and their conversion status across different platforms.

Unlike /entities/active which returns full entity data, this endpoint focuses on version metadata and bundle availability status, making it lighter for version checking use cases.

Body

application/json

pointersstring[]Required

List of pointers to query for version information

Responses

200

List of entity version information

application/json

Version and bundle status information for an entity

pointersstring[]Required

List of pointers where this entity is active

statusstring · enumOptional

Current status of the entity in the registry

Possible values:

400

Bad request - no pointers provided

application/json

post/entities/versions

HTTPcURLJavaScriptPython

POST /entities/versions HTTP/1.1
Host: asset-bundle-registry.decentraland.org
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "pointers": [
    "text"
  ]
}

[
  {
    "pointers": [
      "text"
    ],
    "versions": {
      "assets": {
        "windows": {
          "version": "text",
          "buildDate": "text"
        },
        "mac": {
          "version": "text",
          "buildDate": "text"
        }
      }
    },
    "bundles": {
      "assets": {
        "windows": "pending",
        "mac": "pending"
      },
      "lods": {
        "windows": "pending",
        "mac": "pending"
      }
    },
    "status": "complete"
  }
]