Skip to main content
Early Access - The Dcycle CLI is currently available for enterprise customers. Contact us to learn more about access.

​
Overview

The transport command tracks upstream and downstream transport routes, covering GHG Protocol Scope 3 Categories 4 (Upstream Transportation) and 9 (Downstream Transportation). 
dcy transport <subcommand> [flags]

​
Available Commands

CommandDescription
listList transport routes
showShow transport route details
editEdit a transport route
deleteDelete a transport route

​
List Transport Routes

dcy transport list [flags]

# Aliases
dcy transport ls

​
Examples

# 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

FlagShortDefaultDescription
--type——Direction: upstream or downstream
--status——Filter by status
--year——Filter by year
--page—1Page number
--size—50Page 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

dcy transport show <transport-id>

​
Examples

dcy transport show 00000000-0000-0000-0000-000000000000

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

​
Flags

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

​
Edit Transport Route

dcy transport edit <transport-id> [flags]

​
Examples

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

FlagShortDescription
--name-nRoute name
--supplier-sSupplier name
--quantity-qQuantity transported
--unit-uUnit 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

dcy transport delete <transport-id> [flags]

# Aliases
dcy transport rm <transport-id>

​
Examples

# Interactive confirmation
dcy transport delete <transport-id>

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

​
Flags

FlagShortDefaultDescription
--yes-yfalseSkip confirmation prompt
--org——Organization ID override

​
Common Options

All transport commands support:
FlagDescription
--format jsonJSON output (default: text)
--verboseShow HTTP request/response details
--timeoutRequest timeout in seconds