---
title: "Forward Explorer Events"
method: POST
path: "/forward"
tags: ["Event Forwarding"]
---

# Forward Explorer Events

`POST /forward`

Forwards events from the Decentraland Explorer client. This endpoint processes and validates 
client-side events such as user movement, emotes, login events, and other in-world interactions.

Events are validated for:
- Signature authenticity using HMAC-SHA1
- AuthChain validation for user authentication
- Event structure and content validation
- User address verification

Supported event types:
- `move_to_parcel`: User movement between parcels
- `used_emote`: Emote usage events
- `passport_opened`: Passport interaction events
- `walked_distance`: Movement tracking
- `vertical_height_reached`: Height-based achievements
- `logged_in`: User login events
- `logged_in_cached`: Cached login events

## Request body

- object — Explorer client event data
  - `event` string — Event type identifier
  - `messageId` string — Unique message identifier
  - `anonymousId` string — Anonymous user identifier
  - `userId` string — User identifier (if available)
  - `timestamp` string, date-time — Event timestamp
  - `sentAt` string, date-time — When the event was sent
  - `receivedAt` string, date-time — When the event was received
  - `context` object — Event context information
    - `auth_chain` string — JSON string of authentication chain
    - `dcl_eth_address` string — User's Ethereum address
    - `session_id` string — Session identifier
    - `realm` string — Realm identifier
    - `realm_url` string — Realm URL
    - `dcl_renderer_type` string — Renderer type
    - `launcher_anonymous_id` string — Launcher anonymous ID
    - `ip` string — IP address
    - `parcel` string — Parcel coordinates (for movement events)
    - `position` string — 3D position coordinates
    - `runtime` string — Runtime information
  - `properties` object — Event-specific properties

## Response `200`

Event successfully processed and forwarded

- object
  - `ok` boolean

## Other responses

- `400` — Invalid event data
- `401` — Authentication failed

---

[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)