> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Worlds listele

> TokenLab ile oluşturulmuş tamamlanan World Labs Marble world kayıtlarını listeler

TokenLab ile oluşturulmuş tamamlanan World Labs Marble world kayıtlarını listeleyin. Sonuçlar organizasyonunuzla sınırlıdır; TokenLab paylaşılan upstream hesabının genel listesini açmaz.

Bekleyen veya başarısız üretim görevleri için `/v1/worlds/generations/{id}` kullanın. Bu liste yalnızca üretimden sonra TokenLab tarafından indekslenen tamamlanmış world kayıtlarını döndürür.

## İstek gövdesi

<ParamField body="page_size" type="integer" default="20">
  Döndürülecek world sayısı, 1 ile 100 arası.
</ParamField>

<ParamField body="page_token" type="string">
  Önceki yanıttaki sayfalama tokenı.
</ParamField>

<ParamField body="status" type="string">
  İsteğe bağlı durum filtresi. TokenLab `SUCCEEDED` için tamamlanan world kayıtlarını döndürür; diğer durumlar üretim görevi endpointine aittir.
</ParamField>

<ParamField body="model" type="string">
  İsteğe bağlı Marble model filtresi.
</ParamField>

<ParamField body="tags" type="array">
  İsteğe bağlı etiket filtresi.
</ParamField>

<ParamField body="is_public" type="boolean">
  İsteğe bağlı görünürlük filtresi.
</ParamField>

<ParamField body="created_after" type="string">
  Yalnızca bu zamandan sonra oluşturulan world kayıtlarını döndürür.
</ParamField>

<ParamField body="created_before" type="string">
  Yalnızca bu zamandan önce oluşturulan world kayıtlarını döndürür.
</ParamField>

<ParamField body="sort_by" type="string" default="created_at">
  `created_at` veya `updated_at` ile sırala.
</ParamField>

<ParamField body="sort_order" type="string" default="desc">
  Sıralama yönü: `asc` veya `desc`.
</ParamField>

## Yanıt

<ResponseField name="worlds" type="array">
  World kayıtları dizisi.
</ResponseField>

<ResponseField name="next_page_token" type="string">
  Sonraki sayfa tokenı veya `null`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={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"}'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.tokenlab.sh/v1/worlds/list",
      headers={"Authorization": "Bearer sk-your-api-key"},
      json={"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"},
  )
  print(response.json()["worlds"])
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.tokenlab.sh/v1/worlds/list', {
    method: 'POST',
    headers: {
      Authorization: 'Bearer sk-your-api-key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ page_size: 20, status: 'SUCCEEDED', model: 'marble-1.1' })
  });
  console.log((await response.json()).worlds);
  ```
</RequestExample>