ConnectCloud Developers

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) · “)
    • 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) · “)
    • 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) · “)
    • 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:

{
  "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"

View as Markdown · Interactive reference · OpenAPI