---
title: "Submit multiplayer game progress"
method: POST
path: "/api/multiplayer/progress"
tags: ["Multiplayer"]
---

# Submit multiplayer game progress

`POST /api/multiplayer/progress`

Submit progress for multiple players in a multiplayer game session (Requires bearer token authentication)

## Request body

- object
  - `game_id` string, uuid, required — Game ID
  - `scores` object[], required — Array of player scores
    - `score` number — Game score
    - `level` integer, required — Current level achieved
    - `time` number — Time taken (seconds/milliseconds)
    - `moves` number — Number of moves made
    - `user_name` string, required — User's display name
    - `data` object — Custom game-specific data
    - `user_address` string, required — User's wallet address

## Response `201`

Multiplayer progress submitted successfully

- object
  - `data` object[]
    - `score` number — Game score
    - `level` integer — Current level achieved
    - `time` number — Time taken (seconds/milliseconds)
    - `moves` number — Number of moves made
    - `id` string, uuid, required — Progress entry ID
    - `game_id` string, uuid, required — Game ID
    - `user_address` string, required — User's wallet address
    - `user_name` string, required — User's display name
    - `data` object — Custom game-specific data
    - `updated_at` string, required — Last update timestamp (ISO 8601)

## Other responses

- `400` — Invalid request payload

---

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