> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Transport Routes

> Track upstream and downstream transport routes for Scope 3 emissions

<Note>
  **Early Access** - The Dcycle CLI is currently available for enterprise customers.
  [Contact us](/docs/support) to learn more about access.
</Note>

## Overview

The `transport` command tracks upstream and downstream transport routes, covering GHG Protocol Scope 3 Categories 4 (Upstream Transportation) and 9 (Downstream Transportation).

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
dcy transport <subcommand> [flags]
```

### Available Commands

| Command  | Description                  |
| -------- | ---------------------------- |
| `list`   | List transport routes        |
| `show`   | Show transport route details |
| `edit`   | Edit a transport route       |
| `delete` | Delete a transport route     |

***

## List Transport Routes

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
dcy transport list [flags]

# Aliases
dcy transport ls
```

### Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# List all transport routes
dcy transport list

# By direction
dcy transport list --type upstream
dcy transport list --type downstream

# By year
dcy transport list --year 2024

# Filter by status
dcy transport list --status active

# Pagination
dcy transport list --page 2 --size 100

# JSON output
dcy transport list --format json
```

### Flags

| Flag       | Short | Default | Description                           |
| ---------- | ----- | ------- | ------------------------------------- |
| `--type`   | —     | —       | Direction: `upstream` or `downstream` |
| `--status` | —     | —       | Filter by status                      |
| `--year`   | —     | —       | Filter by year                        |
| `--page`   | —     | `1`     | Page number                           |
| `--size`   | —     | `50`    | Page size                             |
| `--org`    | —     | —       | Organization ID override              |

### Output

```
Showing 3 of 8 transport routes
abc123-... | Raw Materials Import | upstream   | Shanghai -> Barcelona | 12500.00
def456-... | Product Distribution | downstream | Madrid   -> Lisbon    | 625.30
ghi789-... | Supplier Delivery    | upstream   | Paris    -> Madrid    | 1275.00
```

The last column shows the calculated distance in km.

***

## Show Transport Details

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
dcy transport show <transport-id>
```

### Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
dcy transport show 00000000-0000-0000-0000-000000000000

# JSON output
dcy transport show <transport-id> --format json
```

### Flags

| Flag    | Description              |
| ------- | ------------------------ |
| `--org` | Organization ID override |

Shows full route details including origin, destination, distance (km), quantity, unit, supplier, frequency, and calculated CO2e.

***

## Edit Transport Route

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
dcy transport edit <transport-id> [flags]
```

### Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
dcy transport edit <transport-id> --name "New Route Name"
dcy transport edit <transport-id> --quantity 1500 --unit <unit-id>
dcy transport edit <transport-id> --supplier "Acme Logistics"
dcy transport edit <transport-id> --start-date 2024-01-01 --end-date 2024-12-31
```

### Flags

| Flag           | Short | Description                                              |
| -------------- | ----- | -------------------------------------------------------- |
| `--name`       | `-n`  | Route name                                               |
| `--supplier`   | `-s`  | Supplier name                                            |
| `--quantity`   | `-q`  | Quantity transported                                     |
| `--unit`       | `-u`  | Unit of measurement (use `dcy units list` for valid IDs) |
| `--start-date` | —     | Start date (YYYY-MM-DD)                                  |
| `--end-date`   | —     | End date (YYYY-MM-DD)                                    |
| `--org`        | —     | Organization ID override                                 |

***

## Delete Transport Route

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
dcy transport delete <transport-id> [flags]

# Aliases
dcy transport rm <transport-id>
```

### Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Interactive confirmation
dcy transport delete <transport-id>

# Skip confirmation
dcy transport delete <transport-id> --yes
```

### Flags

| Flag    | Short | Default | Description              |
| ------- | ----- | ------- | ------------------------ |
| `--yes` | `-y`  | `false` | Skip confirmation prompt |
| `--org` | —     | —       | Organization ID override |

***

## Common Options

All transport commands support:

| Flag            | Description                        |
| --------------- | ---------------------------------- |
| `--format json` | JSON output (default: `text`)      |
| `--verbose`     | Show HTTP request/response details |
| `--timeout`     | Request timeout in seconds         |