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 approvedapprovedBy(string): Who approved (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)country(string): ISO 3166-1 alpha-2 code of the destination; selects the allowance ratescreatedAt(string (date-time)): When the report was createdcreatedBy(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 rejectiondestination(string): Destination of the tripemployeeId(string): Id of the employeeemployeeName(string): Display name of the employee (in lists)endAt(string): Local return time (YYYY-MM-DDTHH:MM)id(string): Id of the reportitems(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 ofmileage,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 expensekm(number): Kilometres of a mileage itemmerchant(string): Issuer of the receipt (max length 200)receiptId(string): A receipt of the same reportvatCents(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 employeeovernight(boolean): The trip includes overnight stayspurpose(string): Purpose of the tripreceipts(array of TravelReceipt): Receipt files (single reads)contentType(string): Media type of the filecreatedAt(string (date-time)): When the receipt was uploadedcreatedBy(string): Who uploaded the receipt (e-mail)documentId(string): DMS document (owner module hr)fileName(string): File nameid(string): Id of the receiptscanStatus(string): Malware scan of the DMS (one ofPENDING,CLEAN,INFECTED,SKIPPED,FAILED)sizeBytes(integer): Size in bytes
rejectedAt(string (date-time)): When it was rejected lastrejectedBy(string): Who rejected it last (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)releasedAt(string (date-time)): When it was releasedreleasedBy(string): Who released it for payment (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)startAt(string): Local departure time (YYYY-MM-DDTHH:MM)status(string): State of the report (one ofdraft,submitted,approved,rejected,released,transferred)submittedAt(string (date-time)): When the report was submittedtotalCents(integer): Reimbursement in centstotals(object): Drafts and rejected reports: computed with the current rates; fromsubmittedon: frozen at submit.tradeDocumentNo(string): Number of the trade documenttradeTransactionId(string): Id of the trade document created for the reporttransferError(string): The last failed transfer (empty after a success)transferredAt(string (date-time)): When it was transferred to tradeupdatedAt(string (date-time)): When the report was last changedversion(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:
{
"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
curl -X GET 'https://api.mbcom.cloud/api/hr/v1/travel-reports' \
-H "Authorization: Bearer $ACCESS_TOKEN"