Skip to main content
List completed World Labs Marble worlds created through TokenLab. Results are scoped to your organization; TokenLab does not expose the shared upstream account-wide list. Use /v1/worlds/generations/{id} for pending or failed generation tasks. This list returns completed worlds that TokenLab has indexed after generation.

​
Request Body

​
page_size
integer
default:"20"
Number of worlds to return, from 1 to 100.
​
page_token
string
Pagination token from the previous response.
​
status
string
Optional status filter. TokenLab returns completed worlds for SUCCEEDED; other statuses belong to the generation task endpoint.
​
model
string
Optional Marble model filter.
​
tags
array
Optional tag filter.
​
is_public
boolean
Optional visibility filter.
​
created_after
string
Only return worlds created after this timestamp.
​
created_before
string
Only return worlds created before this timestamp.
​
sort_by
string
default:"created_at"
Sort by created_at or updated_at.
​
sort_order
string
default:"desc"
Sort direction: asc or desc.

​
Response

​
worlds
array
Array of world records.
​
next_page_token
string
Token for the next page, or null.
curl -X POST "https://api.tokenlab.sh/v1/worlds/list" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"}'