Three lines



[Webhook] Vehicle Status Change

Privileged and Confidential This endpoint design has been confidentially shared with you. It is still under development and is subject to change without notice. Please do not share this document or API endpoint details with anyone who is not authorized to have access. For more information read about scopes.

This webhook allows the rental company to listen to status change of the vehicles belong to them.

More details about webhooks can be found here.


To be defined by the rental company. This also needs to be registered in developer dashboard.

HTTP Method


Access Method

None. Auth process defined here.

Request Header Parameters

Defined here

Request Query/Body Parameters
Name Type Description
event_id string Unique event identifier, which can be used to ensure that events are only digested once. This is a Uber generated UUID.
event_time long Unix timestamp of the time the event occurred.
event_type string The type of event that occurred. In this case, value would be VEHICLE_STATUS_UPDATED.
meta object The object containing additional information that is specific to the event_type.
Request Query/Body Parameters - Meta
Name Type Description
resource_id string Unique identifier of the resource this event has been generated for. In this case, it’s vehicle_id.
vehicle object Contains the details of the vehicle like current status, last modified timestamp, associated documents status etc.
Request Query/Body Parameters - Vehicle
Name Type Description
updated_at long Epoch timestamp representing when the vehicle was last modified.
status string Status of the vehicle.
documents object_array Array of document requirement object.
Request Query/Body Parameters - Document Requirement Object
Name Type Description
type string Document type of the document for which the status is being returned.
status string Status of the document - pending, missing, active, expired, rejected. Rental company will need to take action when the status is missing, expired or rejected.

Note - Though vehicle’s latest status will be present in the webhook itself, in case rental company still wants to call Get Vehicle API immediately after receiving the webhook, they can compare both the updated_at timestamps( present in the webhook and the one returned by the API) to ensure that the data they are getting from the Get Vehicle API is the latest data.


© 2023 Uber Technologies Inc.