Round-trip

Swap two vehicles between locations. We'll deliver your first vehicle, then hop in your second and bring it right back.

Example Request#

POST /v1/round-trip-moves

{
  "ready_by_time_utc": "2022-03-25T14:00:00Z",
  "move_one": {
    "dealer_contact": "Jane Smith",
    "special_instructions": "Check in at service center",
    "vehicle": {
      "stock": "BK0018",
      "vin": "5GAKRBED5BJ262438",
      "year": "2011",
      "make": "Buick",
      "model": "Enclave",
      "color": "White",
      "manual": false
    },
    "pickup_location": {
      "name": "Denny's Automobiles",
      "address_one": "11161 Research Plaza Way",
      "city": "Richmond",
      "state": "VA",
      "zip": "23236"
    }
  },
  "move_two": {
    "dealer_contact": "Hugh Man",
    "vehicle": {
      "stock": "MB0004",
      "vin": "WDDGF4HB1CR220392",
      "year": "2012",
      "make": "Mercedes-Benz",
      "model": "C-Class",
      "color": "Black",
      "manual": true
    },
    "pickup_location": {
      "name": "Lot 4",
      "address_one": "888 Broad St",
      "city": "Richmond",
      "state": "VA",
      "zip": "23220"
    }
  }
}

Body Params#

Field	Type	Required?	Description
ready_by_time_utc	String	Required	The date and time in YYYY-MM-DD hh:mm:ss format, using UTC/Zulu time. Reference
dealer_contact	String	Optional	Point of contact for our driver when arriving at the pickup location
special_instructions	String	Optional	Additional information such as where to park or a number to call upon arrival
reference_id	String	Optional	Internal reference number number such as a repair order #
stock	String	Optional	Internal stock number associated with the vehicle
vin	String	Optional	Vehicle Identification Number associated with the vehicle
year	String	Optional	Year the vehicle was manufactured
make	String	Required	The make of the vehicle (e.g., "Ford")
model	String	Required	The model of the vehicle (e.g., "F-150")
color	String	Optional	The color of the vehicle
manual	Boolean	Required	Whether or not the vehicle has a manual transmission (true) or an automatic (false)
name	String	Required	Name associated with the pickup location
address_one	String	Required	The street address of the pickup location
address_two	String	Optional	Optional sub-address of the pickup location
city	String	Required	The city that the pickup address is associated with
state	String	Required	The state that the pickup address is associated with
zip	String	Required	The 5-digit Zip Code that the pickup address is associated with

Request Object Structure#

{
  ready_by_time_utc,
  move_one: {
    dealer_contact,
    special_instructions,
    reference_id,
    vehicle: {
      stock,
      vin,
      year,
      make,
      model,
      color,
      manual
    },
    pickup_location: {
      name,
      address_one,
      address_two,
      city,
      state,
      zip
    }
  },
  move_two: {
    dealer_contact,
    special_instructions,
    reference_id,
    vehicle: {
      stock,
      vin,
      year,
      make,
      model,
      color,
      manual
    },
    pickup_location: {
      name,
      address_one,
      address_two,
      city,
      state,
      zip
    }
  }
}

Example Response#

For additional information, see the response section.

200 /v1/round-trip-moves

{
  "move_one": {
    "move_id": 10038,
    "status": null,
    "cancel_status": null,
    "pickup_started": null,
    "pickup_arrived": null,
    "pickup_successful": null,
    "delivery_started": null,
    "delivery_arrived": null,
    "delivery_successful": null,
    "tracking_link": null,
    "move_uri": "https://api.hopdrive.com/v1/moves/10038",
    "lane_uri": "https://api.hopdrive.com/v1/lanes/4990",
    "reference_id": null,
    "dealer_contact": "Jane Smith",
    "special_instructions": "Check in at service center",
    "vehicle": {
      "stock": "BK0018",
      "vin": "5GAKRBED5BJ262438",
      "year": "2011",
      "make": "Buick",
      "model": "Enclave",
      "color": "White",
      "manual": false
    },
    "pickup_location": {
      "name": "Denny's Automobiles",
      "address_one": "11161 Research Plaza Way",
      "city": "Richmond",
      "state": "VA",
      "zip": "23236",
      "lat": 37.5050257,
      "lon": -77.6013313,
      "google_place_id": "ChIJkxCQwnBtsYkR1QqrxNduupo",
      "location_id": 2246,
      "full_address": "11161 Research Plaza Way, Richmond, VA 23236, USA"
    }
  },
  "move_two": {
    "move_id": 10039,
    "status": null,
    "cancel_status": null,
    "pickup_started": null,
    "pickup_arrived": null,
    "pickup_successful": null,
    "delivery_started": null,
    "delivery_arrived": null,
    "delivery_successful": null,
    "tracking_link": null,
    "move_uri": "https://api.hopdrive.com/v1/moves/10039",
    "lane_uri": "https://api.hopdrive.com/v1/lanes/4990",
    "reference_id": null,
    "dealer_contact": "Hugh Man",
    "special_instructions": null,
    "vehicle": {
      "stock": "MB0004",
      "vin": "WDDGF4HB1CR220392",
      "year": "2012",
      "make": "Mercedes-Benz",
      "model": "C-Class",
      "color": "Black",
      "manual": true
    },
    "pickup_location": {
      "name": "Lot 4",
      "address_one": "888 W Broad St",
      "city": "Richmond",
      "state": "VA",
      "zip": "23220",
      "lat": 37.550209,
      "lon": -77.4494655,
      "google_place_id": "Eic4ODggVyBCcm9hZCBTdCwgUmljaG1vbmQsIFZBIDIzMjIwLCBVU0EiGxIZChQKEgkPDdZ3SBGxiRG2k4LRA4YLvxD4Bg",
      "location_id": 2141,
      "full_address": "888 W Broad St, Richmond, VA 23220, USA"
    }
  },
  "ready_by_time_utc": "2022-03-25T14:00:00Z"
}