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

​
Overview

Browse available units of measurement for quantities in purchases, shipments, and transport routes.

​
Available Commands

CommandDescription
dcy units listList available units

​
List Units

dcy units list
Output: 
Showing 12 unit(s)
abc123-... | energy  | kWh
def456-... | energy  | MWh
ghi789-... | mass    | kg
jkl012-... | mass    | t
mno345-... | volume  | L
pqr678-... | volume  | m³
Units are sorted by type, then by name alphabetically.

​
Flags

FlagShortDefaultDescription
--type-t—Filter by unit type (e.g. mass, energy, volume)
--search-s—Search by name (case-insensitive)
--org——Organization ID override

​
Examples

# Short alias
dcy units ls

# Filter by type
dcy units list --type mass

# Search by name
dcy units list --search kg

# Get the ID for a specific unit
dcy units list --format json | jq '.[] | select(.name == "kWh") | .id'

# JSON output
dcy units list --format json | jq '.[] | {id, type, name}'
Use dcy units list to find valid unit IDs for commands like dcy transport edit --unit <unit-id> or dcy shipment create --unit <unit-id>.

​
Aliases

CommandAlias
dcy units listdcy units ls

​
Next Steps

Suppliers

Browse available suppliers

Transport

Track upstream and downstream transport emissions

Shipments

Manage shipment records

Purchases

Manage purchased goods and services