Sign in
latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Entities

Get active entities by pointers

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.

post/entities/active

Request body

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...")

Response

List of active entities

idstring required

Unique entity identifier (content identifier/CID from Catalyst)

typestring required

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.

timestampnumber required

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

metadataobject

Entity-specific metadata (structure varies by entity type):

  • For scenes: includes display name, spawn points, parcels, etc.
  • For wearables: includes name, description, category, rarity, etc.