Concierge

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.

Workflows

Concierge API has two unique workflows, Concierge Search and Concierge Buy.

Concierge Search

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.

Create Order
{
  "type": "concierge",
  "services": ["search"],
  "quoteId": "quote_x5f4d3"
}

Example Response
{
  "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

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
    }
  ]
}

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.

{
  "type": "concierge",
  "services": ["buy"],
  "quoteId": "quote_u3f4d3",
  "vin": "4T1B11HK0KU704570"
}

{
  "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.

Typical Progression

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.

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.

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.

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.

Webhooks

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"
      }
    ]
  }
}

Next Steps

Experience a new era of car buying with Concierge API — where your needs come first.

Quote - Concierge

Quote concierge search and buy services

Order - Concierge

Order concierge search and buy services

Services

Guides

API Reference

Workflows

Concierge Search

Concierge Buy

Typical Progression

Webhooks

Next Steps

Quote - Concierge

Order - Concierge

Services

Guides

API Reference

​Workflows

​Concierge Search

​Concierge Buy

​Typical Progression

​Webhooks

​Next Steps

Quote - Concierge

Order - Concierge

Workflows

Concierge Search

Concierge Buy

Typical Progression

Webhooks

Next Steps