Fetching Move Info

A GET to the /moves endpoint allows your application to fetch current information about a specific move or pair of moves (such as a concierge and loaner pair). Requests made to this endpoint require an authorization header using your authentication token:

Auth Header

curl --request GET \
  --url https://api.hopdrive.com/v1/moves/<move_id> \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <your token>' \
  --data '{ ... }'

When you successfully request a move, you will get back a move_id unique to that request. A GET request to the endpoint https://api.hopdrive.com/moves/<move_id> will return the same response as the original request for the associated move type.

Example Request#

GET /v1/moves/10033

Example Request#

200 /v1/moves/10033

{
  "ready_by_time_utc": "2022-03-24T14:00:00+00:00",
  "move": {
    "id": 10033,
    "status": null,
    "pickup_started": null,
    "pickup_arrived": null,
    "pickup_successful": null,
    "delivery_started": null,
    "delivery_arrived": null,
    "delivery_successful": null,
    "cancel_status": "not cancelled",
    "dealer_contact": "Jane Smith",
    "special_instructions": "Check in at service center",
    "reference_id": null,
    "move_details_url": "https://dealer.socialautotransport.com/moves/10033",
    "tracking_link": null,
    "move_uri": "https://api.hopdrive.com/v1/moves/10033",
    "lane_uri": "https://api.hopdrive.com/v1/lanes/4990",
    "vehicle": {
      "stock": "BK0018",
      "vin": "5GAKRBED5BJ262438",
      "year": "2011",
      "make": "Buick",
      "model": "Enclave",
      "color": "white",
      "manual": false
    }
  },
  "pickup_location": {
    "name": "Denny's Automobiles",
    "lat": 37.5050257,
    "lon": -77.6013313,
    "google_place_id": "ChIJkxCQwnBtsYkR1QqrxNduupo",
    "location_id": 2246,
    "full_address": "11161 Research Plaza Way, Richmond, VA 23236, USA"
  },
  "delivery_location": {
    "name": "Lot 4",
    "lat": 37.550209,
    "lon": -77.4494655,
    "google_place_id": "Eic4ODggVyBCcm9hZCBTdCwgUmljaG1vbmQsIFZBIDIzMjIwLCBVU0EiGxIZChQKEgkPDdZ3SBGxiRG2k4LRA4YLvxD4Bg",
    "location_id": 2141,
    "full_address": "888 W Broad St, Richmond, VA 23220, USA"
  }
}