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

# Expanding Entities

> Expand certain entities within the API response.

Certain entities are returned as a unique ID for brevity. These entities can be expanded into the underlying object when specified via the `expand` request parameter.

```bash Regular theme={null}
curl 'https://api.scale.com/v2/task'
```

```bash Expanded theme={null}
curl 'https://api.scale.com/v2/task?expand=project'
```

```json Regular theme={null}
{
  "project": "abc123",
  "batch": "efg456",
  "delivery": "dce789",
  ...
}
```

```json Expanded theme={null}
{
  "project": {
    "id": "abc123",
    "name": "My Project",
    ...
  },
  "batch": {
    "id": "efg456",
    "name": "my_batch_01",
  },
  "delivery": {
    "id": "dce789",
    "name": "delivery-math-01",
    "task_count": 25,
    "delivered_at": "2023-11-07T05:31:56Z",
    "project": "abc123",
  },
  ...
}
```