> ## 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.

# Units

> Browse available units of measurement for quantities

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

## Overview

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

### Available Commands

| Command          | Description          |
| ---------------- | -------------------- |
| `dcy units list` | List available units |

***

## List Units

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

| Flag       | Short | Default | Description                                           |
| ---------- | ----- | ------- | ----------------------------------------------------- |
| `--type`   | `-t`  | —       | Filter by unit type (e.g. `mass`, `energy`, `volume`) |
| `--search` | `-s`  | —       | Search by name (case-insensitive)                     |
| `--org`    | —     | —       | Organization ID override                              |

### Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# 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}'
```

<Tip>
  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>`.
</Tip>

***

## Aliases

| Command          | Alias          |
| ---------------- | -------------- |
| `dcy units list` | `dcy units ls` |

## Next Steps

<CardGroup cols={2}>
  <Card title="Suppliers" icon="building" href="/cli/suppliers">
    Browse available suppliers
  </Card>

  <Card title="Transport" icon="route" href="/cli/transport">
    Track upstream and downstream transport emissions
  </Card>

  <Card title="Shipments" icon="truck" href="/cli/shipments">
    Manage shipment records
  </Card>

  <Card title="Purchases" icon="shopping-cart" href="/cli/purchases">
    Manage purchased goods and services
  </Card>
</CardGroup>