The platform can now generate your payroll export for you: a recurring CSV report of what drivers earned on their tours¹, with one row per tour covering base earnings, bonuses and tips. It arrives daily, weekly or monthly in your reports section, and the admins it is shared with get an e-mail once it’s ready.

Once a completed tour’s tips are settled, it goes into the next report, and its compensation¹ is frozen from that moment on. No tour is reported twice, and whatever a failed run leaves behind goes into the next one. Tours completed while the report is disabled aren’t reported.

Tour compensation reports are a paid extension configured per tenant. Reach out to our customer success team to enable them.

Where to start

The reports are delivered through the reports API, so everything under the Reports² tag applies: list, open and download them like any other report. They stay available for 60 days. The compensation itself is managed under the Tour Compensation³ tag, and the compensation API guide⁴ walks through setting it.

What’s in a report

• 📅 Nothing left behind. A scheduled run covers every tour completed before midnight in your timezone that no earlier report included; a report our team generates for you on request covers everything up to that moment. Reports are named and tagged after the period of their run, e.g. week:2026-W42 for the run early on Monday, 19 October.
• 🗂️ Grouped the way you pay out. Reports can be split per service area, organization or driver, so each one can be handed on by itself. Every report of a group carries its ID as a tag, e.g. organization_id:<uuid>, so you can pull up one organization’s reports with the tags filter of List reports⁵.
• 🧾 One row per tour. The tour, its bookings and customers, first stop, distance, driver and organization, followed by the compensation¹ in the minor unit of its currency, as in the API: the total, base earnings, tips and up to five bonuses listed by key. The components always add up to the total. A tour without compensation still gets its row, with the money columns left blank.
• ✂️ Large reports continue in further numbered reports, e.g. “(2)” and “(3)”, each within the report file size limit.

To make room for the group tags, report tags can now be up to 60 characters long, both on the generated reports and on the ones you create with Create a report⁶.

What changes for your integration

A reporting status on every tour. Show Booking⁷ returns compensation_reporting_status and compensation_reported_at for tours:

• not_ready while the tour is in flight and until its tips are settled
• ready once it awaits the next report
• reported once a report includes it, with compensation_reported_at recording when
• skipped for tours that never enter a report, e.g. cancelled tours

Reported compensation is locked. Once a tour is reported, Set tour base earnings⁸, Set tour bonus⁹ and their delete counterparts answer 403 Forbidden. Check the tour’s permissions.update_compensation flag to know beforehand: it turns false as soon as a report includes the tour. Make your compensation writes before a tour’s report runs, and correct a payout in your own payroll from then on.

Drivers stay until their tours are reported. The report names the driver of every tour, so Anonymize User¹⁰ answers 422 with driver_with_tours_awaiting_compensation_report while a driver has completed tours still awaiting the report. Retry once a report includes them.