# trips.list

List trips: purchases made while travelling, grouped by stay, with title, place, dates, status (upcoming, active or past), how many transactions belong to each, what it cost per currency (holds left out, hotel credits taken off) and its map centre. Contributors see only trips that include a transaction they own.

`GET | POST /api/v1/accounting/trips.list`

Permissions: `accounting:read` · Roles: admin, finance, contributor

MCP tool: `accounting_trips_list`

## Fields

This action takes no input fields. Send `{}`.

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/trips.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

Reference page: https://app.getoatmilk.com/docs/api/trips.list
