# List Recipes

Return the server’s world recipes in catalog order. Each recipe has a key, a display label, and a tile count. Use its key when creating a generated world.

## Request and Response

GET `/worlds/recipes`

### Response

200application/jsonArray of object values

`key` · string · required

`label` · string · required

`tiles` · integer · required

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

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

url = os.environ["EXULANICA_API_URL"] + f'/worlds/recipes'
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
[
  {
    "key": "string",
    "label": "string",
    "tiles": "integer"
  }
]
```

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)