Learn how to use Concierge Seach and Buy workflows.
The Concierge API streamlines the car buying process, eliminating the typical stress and hassle associated with purchasing a vehicle.
Users can effortlessly connect to a network of Concierges to assist customers in the purchase expereince – find and purchase the ideal vehicle that fit flexible budgets, preferences and requirements.
Effortless Car Buying: The entire process is managed, from search to purchase, with a hands-off approach that allows you to relax while a Concierge expert handle everything.
Transparent Pricing: No hidden fees, offering a clear breakdown of all costs upfront.
Expertise and Savings: Our network of experts negotiates the best possible deals, saving you time and money through efficient workflows.
Concierge Search helps users find their ideal vehicle through personalized assistance, expert knowledge, and industry networks. This service makes searching for the perfect vehicle efficient and hassle-free.
To create a quote for concierge search, you will need to provide the details about the type of vehicle a user is looking for, the budget, and other relevant information.
Create Quote
{"type":"concierge","services":["search"],"items":[{"newUsed":"Used","bodyStyle":"Car","carStyle":"Sedan","yearLower":2018,"yearUpper":2020,"mileageLower":0,"mileageUpper":50000,"exteriorColor":"Black","interiorColor":"Beige","fuelType":"Gasoline","driveTrain":"FWD","transmission":"Automatic","comfort":["Leather/Premium Seats","Heated Seats"],"safety":["Backup Camera","Blind Spot Monitor"],"entertainment":["Bluetooth","Navigation System"],"utility":["Sunroof/Moonroof/Panoramic Roof"],"purchaseOption":"Finance","cashDown":5000,"monthlyPayment":700,"creditScore":"Good Credit (700-749)","timeToPurchase":"2-4 weeks","firstName":"Johnny","lastName":"Good","email":"johnnybgood@gmail.com","phone":"561-555-1212","zipcode":"33410","comments":"Looking for a low-mileage used sedan with leather seats"}]}
Example Response
{"id":"quote_x5f4d3","lead":"62ae14b3e239n5tte1d74w2rc","status":"pending","estimatedTime":"2024-05-30T12:00:00Z","checkoutLink":"https://checkout.driv.ly/quote_x5f4d3","paid":false,"total":750,"items":[{"service":"concierge","price":750,"name":"Concierge Search for Johnny Good","description":"Looking for a low-mileage used sedan with leather seats.","quantity":1}]}
Upon payment, a service order will be generated with all pertinent details and an estimated completion time. Progress of the service order can be monitored using webhooks, ensuring timely updates throughout the search process.
Creating an order will allow you to start the process of concierge search, where a concierge agent will begin search for the vehicle based on the user’s requirements.
{"id":"order_x5f4d3","lead":"62ae14b3e239n5tte1d74w2rc","status":"ordered","estimatedTime":"2024-05-30T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_x5f4d3","paid":true,"total":750,"items":[{"service":"concierge","price":750,"name":"Concierge Search for Johnny Good","description":"Looking for a low-mileage used sedan with leather seats","quantity":1}]}
You’ll be notified of the service order’s status via webhooks, ensuring you’re always up-to-date on the progress of your vehicle search.
Concierge Buy is a service that allows users to purchase a vehicle through the Concierge platform. By leveraging Concierge Buy, users can easily order a vehicle, complete the purchase process, and have the vehicle delivered to their doorstep without the hassle of traditional car buying.
To create a quote for concierge buy, you will need to provide the details about the vehicle you want to purchase and other relevant information.
{"type":"concierge","services":["buy"],"items":[{"vin":"4T1B11HK0KU704570","priceLower":15000,"priceUpper":25000,"purchaseOption":"Finance","cashDown":5000,"creditScore":"Good Credit (700-749)","timeToPurchase":"1-2 weeks","firstName":"Johnny","lastName":"Good","email":"johnnybgood@gmail.com","phone":"561-555-1212","zipcode":"33410","comments":"Looking to finance 4T1B11HK0KU704570"}]}
{"id":"quote_u3f4d3","lead":"62ae14b3e239n5tte1d74w2rc","status":"pending","estimatedTime":"2024-05-30T12:00:00Z","checkoutLink":"https://checkout.driv.ly/quote_u3f4d3","paid":false,"total":250,"items":[{"service":"concierge","price":250,"name":"Concierge Buy for Johnny Good","description":"Looking to finance 4T1B11HK0KU704570","quantity":1}]}
Upon payment, a service order will be generated with all pertinent details and an estimated completion time. Progress of the service order can be monitored using webhooks, ensuring timely updates throughout the purchase process.
Creating an order will allow you to start the process of concierge buy, where a concierge agent will begin the purchase process for the vehicle based on the user’s requirements.
{"id":"order_u3f4d3","lead":"62ae14b3e239n5tte1d74w2rc","status":"ordered","estimatedTime":"2024-05-30T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_u3f4d3","paid":true,"total":250,"items":[{"service":"concierge","price":250,"name":"Concierge Buy for Johnny Good","description":"Looking to finance 4T1B11HK0KU704570","quantity":1}]}
You’ll be notified of the service order’s status via webhooks, ensuring you’re always up-to-date on the progress of your vehicle purchase.
Lets go through a typical progression of a concierge search and concierge buy service order. If any issues arise, the status of the service order will be updated to either delayed or canceled, and you will be notified via webhooks.
1
After payment is successful
A service order is created with the details of your quote, including the estimated time and cost.
The service order will start in the pending status, this means that its just waiting for the team to start work.
2
After some time has passed
The service order will progress to the in-progress status, this means that the team has started working on the order.
3
Order is completed
Once the service is completed, the status will be updated to completed, and you will be notified of the completion via email and webhook.
service.created - This event is triggered when a service order is created, providing you with the details of the order:
{"event":"service.created","type":"concierge","data":{"id":"order_x5f4d3","lead":"62ae14b3e239n5tte1d74w2rc","status":"ordered",// pending, in-progress, completed, delayed, canceled"estimatedTime":"2024-05-30T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_x5f4d3","paid":true,"total":750,"items":[{"service":"concierge","price":750,"name":"Concierge Search for Johnny Good","description":"Looking for a low-mileage used sedan with leather seats","quantity":1}],"history":[// An Array to show the keys changed and when{"status":"pending","paid":true,"time":"2024-05-30T12:00:00Z"}]}}
service.updated - This event is triggered when a service order is updated, for example, when the team has started working on the order or when the service has an issue:
{"event":"service.updated","type":"concierge","data":{"id":"order_x5f4d3","lead":"62ae14b3e239n5tte1d74w2rc","status":"ordered","estimatedTime":"2024-05-30T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_x5f4d3","paid":true,"total":750,"items":[{"service":"concierge","price":750,"name":"Concierge Search for Johnny Good","description":"Looking for a low-mileage used sedan with leather seats","quantity":1}],"history":[{"status":"pending","paid":true,"time":"2024-05-30T12:00:00Z"},{"status":"in-progress","time":"2024-05-31T12:00:00Z"}]}}
service.completed - This event is triggered when a service order is completed, providing you with the final details of the order:
{"event":"service.completed","type":"concierge","data":{"id":"order_x5f4d3","lead":"62ae14b3e239n5tte1d74w2rc","status":"ordered","estimatedTime":"2024-05-30T12:00:00Z","receiptLink":"https://checkout.driv.ly/order_x5f4d3","paid":true,"total":750,"items":[{"service":"concierge","price":750,"name":"Concierge Search for Johnny Good","description":"Looking for a low-mileage used sedan with leather seats","quantity":1}],"history":[{"status":"pending","paid":true,"time":"2024-05-30T12:00:00Z"},{"status":"in-progress","time":"2024-05-31T12:00:00Z"},{"status":"completed","time":"2024-06-10T12:00:00Z"}]}}