# Chains Commands

> See [Chains module docs](../../modules/chains) for permissions and data model.

# Chains Commands

See [Chains module docs](../../modules/chains) for permissions and data model.

### `soat list-chains`

List continuation chains

- Method: `GET`
- Path: `/api/v1/chains`

#### Usage

```bash
soat list-chains
```

#### Options

##### `--project-id`

Project ID (required if not using project key auth)

- Source: `query`
- Required: no
- Type: `string`
- Example: `proj_V1StGXR8Z5jdHi6B`

##### `--status`

Filter by chain status

- Source: `query`
- Required: no
- Type: `enum("active", "concluded", "expired", "budget_exhausted")`

##### `--agent-id`

Filter by the agent whose continuation opened the chain

- Source: `query`
- Required: no
- Type: `string`
- Example: `agent_V1StGXR8Z5jdHi6B`

##### `--limit`

Maximum number of results to return

- Source: `query`
- Required: no
- Type: `integer`
- Default: `50`

##### `--offset`

Number of results to skip

- Source: `query`
- Required: no
- Type: `integer`
- Default: `0`

### `soat get-chain`

Get a continuation chain

- Method: `GET`
- Path: `/api/v1/chains/{chain_id}`

#### Usage

```bash
soat get-chain
```

#### Options

This command has no options.