# Read Society State

Read the society attached to this version, including its current state and the places its inhabitants can visit.

## Request and Response

GET `/world/versions/{version_id}/society`

This operation requires a world with a society. Discover support through the version’s capabilities.

### Parameters

`version_id` · path, uuid · required

`world_id` · query, string · required

`places` · query, boolean · optional

### Response

200application/jsonvalue

```bash
curl --fail-with-body \
  "$EXULANICA_API_URL/world/versions/$VERSION_ID/society?world_id=$WORLD_ID" \
  -H "Authorization: Bearer $EXULANICA_TOKEN"
```

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

url = os.environ["EXULANICA_API_URL"] + f'/world/versions/{os.environ["VERSION_ID"]}/society?world_id={os.environ["WORLD_ID"]}'
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
"value"
```

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)