Get vehicle information

GET /v2/post_checkout/orders/{order_id}/pickup/vehicle_info

Retrieves information about the customer's vehicle. With the make and model, the runner can easily find the vehicle within the store's designated pickup area. With the license plate number, the runner can verify that they have the correct customer before placing the order in the vehicle.

Security

Name	In	Description
Authorization	header	The Authorization header with the bearer token acquired during authentication.

Parameters

Name	In	Type	Required	Description
order_id	path	string		The ID of the order.

Request

None.

Request examples

cURL

curl --request GET \
  --url 'https://connect.instacart.com/v2/post_checkout/orders/{order_id}/pickup/vehicle_info' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <token>'

Java

HttpResponse<String> response = Unirest.get("https://connect.instacart.com/v2/post_checkout/orders/{order_id}/pickup/vehicle_info")
  .header("Accept", "application/json")
  .header("Authorization", "Bearer <token>")
  .asString();

Python

import http.client

conn = http.client.HTTPSConnection("connect.instacart.com")

headers = {
    'Accept': "application/json",
    'Authorization': "Bearer <token>"
}

conn.request("GET", "/v2/post_checkout/orders/{order_id}/pickup/vehicle_info", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Go

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://connect.instacart.com/v2/post_checkout/orders/{order_id}/pickup/vehicle_info"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Accept", "application/json")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Response

Field	Type	Required	Description
vehicle_info	VehicleInfo		The vehicle info.

VehicleInfo Object

Field	Type	Required	Description
id	integer		The ID of the vehicle.
model	string		The model of the vehicle.
vehicle_type	string		The type of vehicle.
license_plate	string		The license plate of the vehicle.
color	string		The vehicle color.
color_hex	string		The vehicle color in hexadecimal.

Response examples

200 Success

200 Vehicle Fetched

{
  "vehicle_info": {
    "id": 123,
    "model": "SomeCarModel",
    "vehicle_type": "sedan",
    "license_plate": "F4K3L1C3NC3",
    "color": "silver",
    "color_hex": "#E8E8E8"
  }
}

200 No vehicle

{
 // Empty
}

4XX Errors

Error responses return either a single error or multiple errors.

HTTP Code	Cause	Error Message	Error Code	Error Meta
400	Invalid params	"Pickup unavailable for non-pickup orders"	4001	Not applicable
404	Order not found	"Resource not found"	4000	Not applicable