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

# Business Travel

> Track corporate travel emissions — flights, trains, car rentals

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

## Overview

The `travel` command tracks corporate travel emissions, covering GHG Protocol Scope 3 Category 6 (Business Travel) — flights, trains, car rentals, and other business trips.

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

### Available Commands

| Command | Description           |
| ------- | --------------------- |
| `list`  | List business travels |

***

## List Travels

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

# Aliases
dcy travel ls
```

### Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# List all business travels
dcy travel list

# By year
dcy travel list --year 2024

# By month
dcy travel list --month 2024-03

# Filter by status
dcy travel list --status active

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

# JSON for scripting
dcy travel list --format json
```

### Flags

| Flag       | Short | Default | Description                                                             |
| ---------- | ----- | ------- | ----------------------------------------------------------------------- |
| `--year`   | —     | —       | Filter by year                                                          |
| `--month`  | —     | —       | Filter by month (YYYY-MM format)                                        |
| `--status` | —     | —       | Filter by status (`active`, `pending`, `loading`, `completed`, `error`) |
| `--page`   | —     | `1`     | Page number                                                             |
| `--size`   | —     | `50`    | Page size                                                               |
| `--org`    | —     | —       | Organization ID override                                                |

### Output

```
Showing 5 of 12 business travels in Acme Corp
abc12345-... | MAD-BCN Flight   | 2024-03-15 | Madrid    -> Barcelona | plane
def67890-... | Train to Paris   | 2024-04-02 | Barcelona -> Paris     | train
ghi11223-... | Client Visit     | 2024-05-10 | Madrid    -> Lisbon    | car
```

***

## Common Options

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

***

## Workflows

### Piping with jq

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# Extract travel types
dcy travel list --format json | jq '[.[] | {origin, destination, transport_type}]'

# Count travels by type
dcy travel list --format json | jq 'group_by(.transport_type) | map({type: .[0].transport_type, count: length})'

# Export year's travel data
dcy travel list --year 2024 --format json --size 500 > travels-2024.json
```