Changelog

Changelog#

2026-03-12#

TripStateService#

Released v1. v1beta5 is deprecated.

Breaking

  • The Trip.violations field is removed. This field was always an empty list.

  • The Vehicle message is modified. Before, the location and heading of the vehicle were expressed in two fields. Now, they are are expressed in a single field of type LatLonWithHeading.

  • The CUSTOMER_UNAUTHENTICATED error reason on the CancelTripAsCustomer RPC is reworked. Before, this error reason was used if the trip did not belong to the provided customer or the customer did not exist. Now, there are two distinct error reasons: CUSTOMER_UNAUTHENTICATED if the provided customer ID does not exist, and CUSTOMER_UNAUTHORIZED if the trip does not belong to the provided customer ID.

Updates

  • The Trip.pickup_time and Trip.dropoff_time fields are no longer optional. These fields are always set, either with the time when the pickup/drop-off happened, or with the estimated time when the pickup/drop-off will happen.

2026-02-25#

Webhooks#

Additions

2026-01-28#

BoardingAuthenticationService#

Released v1. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started). v1beta1 is deprecated.

2026-01-13#

TripStateService#

Additions

  • Added two new Trip states, which are only relevant for Trips served by vehicles that require authentication via the BoardingAuthenticationService:

  • StateInFulfillment.Phase.PHASE_READY_FOR_BOARDING_AUTHENTICATION: the vehicle has reached the pickup stop location and is ready for boarding authentication.

  • StateInFulfillment.Phase.PHASE_BOARDING_AUTHENTICATION_COMPLETED: completed the authentication process for boarding the vehicle.

2025-10-28#

ServiceAreaService#

Support for v1beta2 is dropped.

2025-09-03#

TripStateService#

Additions

  • Added visual impairment support on trips. Visual impairment support can be requested using the visual_impairment_support field of RequestTripOffers when requesting a trip offer.

ServiceAreaService#

Released v1. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started). v1beta2 is deprecated.

2025-08-19#

TripStateService#

Released v1beta5. TripService has been renamed to TripStateService and released under v1beta5. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started). v1beta4 is deprecated.

Migration guide#

Trip.state modelling has been changed. Here is the corresponding mapping:

Old state enum value

Corresponding new state

STATE_ORDERED

StateOrdered {}

STATE_ACCEPTED

StateInFulfillment { Phase.PHASE_ACCEPTED }

STATE_PICKED_UP

StateInFulfillment { Phase.PHASE_PICKED_UP }

STATE_DROPPED_OFF

StateFulfilled {}

STATE_REJECTED

StateNotFulfilled { Reason.REASON_REJECTED }

STATE_CANCELLED

StateNotFulfilled { Reason.REASON_CANCELLED_AS_CUSTOMER } or StateNotFulfilled { Reason.REASON_CANCELLED_AS_INTEGRATOR }

STATE_TERMINATED

StateNotFulfilled { Reason.REASON_TERMINATED }

STATE_NO_SHOW

StateNotFulfilled { Reason.REASON_NO_SHOW }

BoardingAuthenticationService#

Released v1beta1. This service was split from the TripService. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started).

2025-07-10#

RefundService#

Released v1. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started). v1beta1 is not supported anymore.

2025-07-08#

ServiceAreaService#

Updates

  • Updated the package from ridepooling to trip. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started).

Removals

  • The old package is not supported anymore.

2025-07-03#

FeedbackService#

Released v1. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started). v1beta1 is deprecated.

2025-07-01#

CustomerService#

Released v1. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started). v1beta1 is deprecated.

2025-06-19#

General#

Updates

  • Updated the URLs under which the Trip API is available in the Introduction.

2025-06-10#

General#

Updates

  • Renamed the Ridepooling API to Trip API. To continue using the API, the Protobuf definitions need to be re-downloaded (see Getting Started).

2025-06-02#

RefundService#

Additions

  • Added GetRefund. To use this new RPC, the Protobuf definitions need to be re-downloaded (see Getting Started).

2025-05-07#

Sandbox#

Released the Ridepooling API Sandbox, see its documentation.

2025-05-06#

FeedbackService#

Updates

  • Renamed field feedback_form to feedback_forms in ListPendingCustomerFeedbackFormsResponse message.

2025-04-30#

TripService#

Updates

  • Changed field location in Vehicle message to optional.

2025-04-25#

TripService#

Released v1beta4. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started).

Breaking

  • Renamed field price to gross_amount in PricePart and Price messages.

  • Added net_amount and tax_rate to Price message.

  • Re-numbered fields in Price and PricePart messages.

Removals

  • v1beta3 is deprecated and support is dropped.

2025-04-11#

RefundService#

Released v1beta1

Additions

2025-02-28#

TripService#

Released v1beta3. To use this new version, the Protobuf definitions need to be re-downloaded (see Getting Started).

Breaking

  • Replaced vehicle_id field with vehicle field in Trip message.

  • Re-numbered fields in Trip message.

Removals

  • v1beta2 is deprecated and support is dropped.

Additions

  • Added ApproachSpeed to Trip and RequestTripOffersRequest messages.

2025-01-28#

ServiceAreaService#

Updates

  • Renamed file from servicearea.proto to service_area.proto.

2025-01-20#

General#

Updates

  • Labelled start and end as optional in common type moia.type.v1.TimeInterval.

2025-01-15#

CustomerService#

Additions

2025-01-14#

FeedbackService#

Updates

2024-12-23#

FeedbackService#

Released v1beta1

Additions

2024-12-04#

ServiceAreaService#

Released v1beta2

Breaking

  • Replaced service_hours in ServiceAreaService with service_hour_intervals.

Removals

  • v1beta1 is deprecated and support is dropped.

Updates

2024-11-22#

ServiceAreaService#

Released v1beta1

Additions

  • Added GetServiceArea, ListServiceAreas and ListServiceHours RPCs. To use these new RPCs, the Protobuf definitions need to be re-downloaded (see Getting Started).

  • Added Guides - Service Area page.

CustomerService#

Released v1beta1

Additions

2024-10-02#

General#

Additions

  • Added Common Types moia.type.v1.Money, moia.type.v1.LatLon and moia.type.v1.TimeInterval (see API Concepts for more information).

TripService#

Released v1beta2

Additions

  • Added RPCs CancelTripAsCustomer, CancelTripAsIntegrator, GetTrip, AuthenticateForBoarding and ListBoardingAuthenticationMethods. To use these new RPC, the Protobuf definitions need to be re-downloaded (see Getting Started).

  • Added fields name, service_area_id and price to the Trip message.

  • Added Fundamentals - Trip page.

  • Added Guides - Autonomous Trip page.

Breaking

  • Replaced Money in TripService with moia.type.v1.Money.

  • Replaced LatLng in TripService with moia.type.v1.LatLon.

  • Replaced Interval in TripService with moia.type.v1.TimeInterval.

Removals

  • Removed customer_id from RequestTripOffersRequest, RequestTripOffersResponse, OrderTripRequest and OrderTripResponse.

  • v1beta1 is deprecated and support is dropped.

Updates

  • Renamed Field service_class to service_class_id in Message Offer.

  • Renamed Field service_class to service_class_id in Message Trip.

2024-09-02#

TripService#

Released v1beta1

Additions

  • Added RPCs RequestTripOffers and OrderTrip.

2024-08-26#

Additions