## List travel expense reports

`GET /api/hr/v1/travel-reports`

Module: HR · operationId: `listTravelReports` · Tag: Travel expenses · Auth: access token (`Authorization: Bearer <accessToken>`)

`hr:travel:approve` and `hr:travel:manage` see every report, managers their own and those of
the people they are responsible for (chain of command and deputies), everyone else their own.
Items and receipts are only in `GET /travel-reports/{id}`.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `employeeId` | query | string |  | Employee id or `me` for the caller's own reports |
| `team` | query | string |  | `mine` = only the people the caller is responsible for (one of `mine`) |
| `responsible` | query | string |  | `me` = reports where the caller should decide first (as for absences) (one of `me`) |
| `status` | query | string |  | Comma-separated statuses |
| `from` | query | string (date) |  | Trips ending on or after this date |
| `to` | query | string (date) |  | Trips starting on or before this date |
| `limit` | query | integer |  | 1–200; another value is a 400 invalid. (default `50`; max 200) |
| `offset` | query | integer |  | (default `0`) |

### Responses

- **200** A page of reports, latest trip first (`application/json`)
- **400** Error (`application/json`)

Fields of the 200 answer:

- `items` (array of TravelReport): Reports of this page (without items and receipts)
  - `approvedAt` (string (date-time)): When it was approved
  - `approvedBy` (string): Who approved (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · <Name>“)
  - `country` (string): ISO 3166-1 alpha-2 code of the destination; selects the allowance rates
  - `createdAt` (string (date-time)): When the report was created
  - `createdBy` (string): Who created the report (e-mail)
  - `days` (array of TravelDay): What was provided per day (meals, lodging lump sum)
    - `breakfast` (boolean): Breakfast provided (cuts the allowance by breakfastPercent of the full-day rate)
    - `date` (string (date)): Day of the trip (YYYY-MM-DD)
    - `dinner` (boolean): Dinner was provided (reduces the meal allowance)
    - `lodgingLumpSum` (boolean): The night after this day without a hotel receipt (lodging lump sum)
    - `lunch` (boolean): Lunch was provided (reduces the meal allowance)
  - `decisionNote` (string): Reason of the last rejection
  - `destination` (string): Destination of the trip
  - `employeeId` (string): Id of the employee
  - `employeeName` (string): Display name of the employee (in lists)
  - `endAt` (string): Local return time (YYYY-MM-DDTHH:MM)
  - `id` (string): Id of the report
  - `items` (array of TravelItem): Expenses (single reads)
    - `date` (string (date), required): Date of the expense (YYYY-MM-DD)
    - `kind` (string, required): Kind of expense; mileage items carry km and are priced with the tenant rate (one of `mileage`, `transport`, `lodging`, `other`)
    - `amountCents` (integer): Gross amount in cents; computed for mileage (km × rate)
    - `description` (string): What was paid for (max length 200)
    - `id` (string, read-only): Id of the expense
    - `km` (number): Kilometres of a mileage item
    - `merchant` (string): Issuer of the receipt (max length 200)
    - `receiptId` (string): A receipt of the same report
    - `vatCents` (integer): VAT contained in the amount, always computed from amountCents and vatRate (a sent value is ignored; record a receipt with several rates as one item per rate)
    - `vatRate` (number): VAT rate in percent
  - `note` (string): Note of the employee
  - `overnight` (boolean): The trip includes overnight stays
  - `purpose` (string): Purpose of the trip
  - `receipts` (array of TravelReceipt): Receipt files (single reads)
    - `contentType` (string): Media type of the file
    - `createdAt` (string (date-time)): When the receipt was uploaded
    - `createdBy` (string): Who uploaded the receipt (e-mail)
    - `documentId` (string): DMS document (owner module hr)
    - `fileName` (string): File name
    - `id` (string): Id of the receipt
    - `scanStatus` (string): Malware scan of the DMS (one of `PENDING`, `CLEAN`, `INFECTED`, `SKIPPED`, `FAILED`)
    - `sizeBytes` (integer): Size in bytes
  - `rejectedAt` (string (date-time)): When it was rejected last
  - `rejectedBy` (string): Who rejected it last (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · <Name>“)
  - `releasedAt` (string (date-time)): When it was released
  - `releasedBy` (string): Who released it for payment (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · <Name>“)
  - `startAt` (string): Local departure time (YYYY-MM-DDTHH:MM)
  - `status` (string): State of the report (one of `draft`, `submitted`, `approved`, `rejected`, `released`, `transferred`)
  - `submittedAt` (string (date-time)): When the report was submitted
  - `totalCents` (integer): Reimbursement in cents
  - `totals` (object): Drafts and rejected reports: computed with the current rates; from `submitted` on: frozen at submit.
  - `tradeDocumentNo` (string): Number of the trade document
  - `tradeTransactionId` (string): Id of the trade document created for the report
  - `transferError` (string): The last failed transfer (empty after a success)
  - `transferredAt` (string (date-time)): When it was transferred to trade
  - `updatedAt` (string (date-time)): When the report was last changed
  - `version` (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
- `total` (integer): Number of all matching reports

Example 200 answer:

```json
{
  "items": [
    {
      "approvedAt": "2026-11-07T08:15:00Z",
      "approvedBy": "tobias.hartl@muster-it.example",
      "country": "DE",
      "createdAt": "2026-11-06T07:40:00Z",
      "createdBy": "jonas.bauer@muster-it.example",
      "destination": "Alpenhotel Seeblick, Schönau am Königssee",
      "employeeId": "f2a4c6e8-0b2d-4f4a-8c6e-8a0c2e4b6d1c",
      "employeeName": "Jonas Bauer",
      "endAt": "2026-11-05T18:30",
      "id": "0d2f4b6d-8f0b-4d2f-8b6d-8f0b2d4f6b46",
      "overnight": true,
      "purpose": "WLAN-Ausleuchtung und Access-Point-Montage",
      "startAt": "2026-11-04T06:45",
      "status": "approved",
      "submittedAt": "2026-11-06T07:52:00Z",
      "totalCents": 23440,
      "updatedAt": "2026-11-07T08:15:00Z",
      "version": 3
    },
    {
      "country": "DE",
      "createdAt": "2026-11-14T09:05:00Z",
      "createdBy": "lena.vogel@muster-it.example",
      "destination": "Messe Nürnberg",
      "employeeId": "a4c6e8f0-2b4d-4e6f-9a1c-3e5f7b9d1c0a",
      "employeeName": "Lena Vogel",
      "endAt": "2026-11-13T19:30",
      "id": "6d8f0b2d-4f6b-4d8f-9b2d-4f6b8d0f2b49",
      "overnight": false,
      "purpose": "Messebesuch it-sa",
      "startAt": "2026-11-13T07:00",
      "status": "submitted",
      "submittedAt": "2026-11-14T09:20:00Z",
      "totalCents": 10880,
      "updatedAt": "2026-11-14T09:20:00Z",
      "version": 2
    }
  ],
  "total": 2
}
```

### Example request

```bash
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/travel-reports' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
