# List Worlds

Return the worlds in your workspace and its world-count policy. Use the returned world ID when reading a world’s content.

## Request and Response

GET `/worlds`

### Response

200application/json`policy` · object · required

**Show properties**

`policy_id` · string · required

`version` · integer · required

`sha256` · string · required

`limits` · object · required

`worlds` · object[] · required

**Show properties**

Array of object values

`world_id` · string · required

`kind` · string · required

`created_at` · date-time · required

`created_by` · uuid | null · required

`provenance` · object · required

```bash
curl --fail-with-body \
  "$EXULANICA_API_URL/worlds" \
  -H "Authorization: Bearer $EXULANICA_TOKEN"
```

```python
import json
import os
import urllib.request

url = os.environ["EXULANICA_API_URL"] + f'/worlds'
headers = {
    "Authorization": "Bearer " + os.environ["EXULANICA_TOKEN"]
}
request = urllib.request.Request(
    url, headers=headers, method="GET"
)
with urllib.request.urlopen(request) as response:
    print(json.load(response))
```

**200 Response structure**

```json
{
  "policy": {
    "policy_id": "string",
    "version": "integer",
    "sha256": "string",
    "limits": "object"
  },
  "worlds": [
    {
      "world_id": "string",
      "kind": "string",
      "created_at": "date-time",
      "created_by": "uuid | null",
      "provenance": "object"
    }
  ]
}
```

Types and structure, not a live response. Expand properties for the complete field definitions.

## Authentication

Send `Authorization: Bearer <token>` with a token for your workspace. Read operations require `world.read`; writes require `world.write`.

[Authentication and access](/docs/authentication)