---
title: "Get World Labs world"
method: GET
path: "/v1/worlds/{id}"
tags: ["Worlds"]
---

# Get World Labs world

`GET /v1/worlds/{id}`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/worlds/{id}`
- Auth: HTTP bearer

Retrieves a World Labs world generated through TokenLab. The world ID must be owned by the authenticated organization.

## Path parameters

- `id` string, required

## Response `200`

World details

- object
  - `display_name` string
  - `world_id` string, required
  - `world_marble_url` string, uri
  - `assets` object
  - `created_at` string, date-time, nullable
  - `model` string, nullable
  - `permission` object
  - `tags` string[], nullable
  - `updated_at` string, date-time, nullable
  - `world_prompt` object

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `403` (unresolved $ref)
- `404` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)