Three lines



[API] Transfer Vehicle

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.

Transfers the ownership of a vehicle from one organization to another within the same vehicle supplier.



HTTP Method


Access Method

Client Credentials

Required scopes


Example Request
curl -X POST "" \
-H "Authorization: Bearer <TOKEN>" \
-H "Content-Type: application/json" \
-d '{

Request Path Parameters
Name Type Description
vehicle_id string Vehicle ID returned from Create Vehicle response.
Request Body Parameters
Name Type Description
new_owner_id string ID of the new vehicle supplier who will own the vehicle.

Response Fields
Name Type Description
vehicle object Vehicle object

Vehicle object fields

Name Type Description
id string Vehicle ID
owner_id string ID of the vehicle supplier that owns the vehicle
make string Make of the vehicle
model string Model of the vehicle
year int Make year of the vehicle
vin string Vin (chassis number) of the vehicle
license_plate string License plate ID of the vehicle
color_hex_code string Hex code of the vehicle color, e.g. FFFFFF for white color
color_name string Name of the vehicle color, e.g. White
last_updated int Last updated timestamp of the vehicle in milliseconds
Example Response
Status-code: 200
  "vehicle": {
    "id": "<vehicle_id>",
    "owner_id": "<owner_id>",
    "make": "Honda",
    "model": "Civic",
    "year": 2020,
    "vin": "1FMCU14T6JU400773",
    "license_plate": "TEST-123",
    "color_name": "white",
    "last_updated": 1585339676000

Endpoint Specific Errors
Http Status Code Code Message
400 bad_request The request parameters are invalid
401 unauthorized Invalid OAuth 2.0 credentials provided
404 vehicle_not_found Vehicle was not found or not authorized
404 organization_not_found Supplier organization was not found or not authorized
422 transfer_assigned_vehicle It is not allowed to transfer an assigned vehicle
429 rate_limited Number of requests exceeds allowed limit
500 internal_server_error Internal server error
503 service_unavailable Service unavailable


© 2023 Uber Technologies Inc.