---
title: "Get active entities by pointers"
method: POST
path: "/entities/active"
tags: ["Entities"]
---

# Get active entities by pointers

`POST /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.

## Request body

- object
  - `pointers` string[], 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 `200`

List of active entities

- object[]
  - `id` string, required — Unique entity identifier (content identifier/CID from Catalyst)
  - `type` string, 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
  - `pointers` string[], 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.
  - `timestamp` number, required — Unix timestamp (milliseconds) indicating when this entity was deployed to Catalyst
  - `content` object[] — Array of content files associated with this entity, including the converted asset bundle files. Each content item includes the file path and its hash for retrieval from the CDN.
    - `file` string, required — Relative file path of the content within the entity (e.g., "scene.json", "thumbnail.png", or converted asset bundle file names)
    - `hash` string, required — Content identifier (CID) hash of the file, used to retrieve the actual file from the Catalyst content server or Asset Bundle CDN
  - `metadata` object — 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.

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)