> ## Documentation Index
> Fetch the complete documentation index at: https://docs.driv.ly/llms.txt
> Use this file to discover all available pages before exploring further.

# Concierge

> Learn how to use Concierge Seach and Buy workflows.

export const CustomCallout = ({children, variant, icon}) => <>
    {variant === 'tip' && <div className="my-4 px-5 py-4 overflow-hidden rounded-xl border border-emerald-500/20 bg-emerald-50/50 dark:border-emerald-500/30 dark:bg-emerald-500/10">
        <div className="flex items-start space-x-3">
          {icon && <div className="mt-0.5 w-4">
              <svg width="11" height="14" viewBox="0 0 11 14" fill="currentColor" xmlns="http://www.w3.org/2000/svg" className="text-emerald-600 dark:text-emerald-400/80 w-3.5 h-auto" aria-label="CustomTip">
                <path d="M3.12794 12.4232C3.12794 12.5954 3.1776 12.7634 3.27244 12.907L3.74114 13.6095C3.88471 13.8248 4.21067 14 4.46964 14H6.15606C6.41415 14 6.74017 13.825 6.88373 13.6095L7.3508 12.9073C7.43114 12.7859 7.49705 12.569 7.49705 12.4232L7.50055 11.3513H3.12521L3.12794 12.4232ZM5.31288 0C2.52414 0.00875889 0.5 2.26889 0.5 4.78826C0.5 6.00188 0.949566 7.10829 1.69119 7.95492C2.14321 8.47011 2.84901 9.54727 3.11919 10.4557C3.12005 10.4625 3.12175 10.4698 3.12261 10.4771H7.50342C7.50427 10.4698 7.50598 10.463 7.50684 10.4557C7.77688 9.54727 8.48281 8.47011 8.93484 7.95492C9.67728 7.13181 10.1258 6.02703 10.1258 4.78826C10.1258 2.15486 7.9709 0.000106649 5.31288 0ZM7.94902 7.11267C7.52078 7.60079 6.99082 8.37878 6.6077 9.18794H4.02051C3.63739 8.37878 3.10743 7.60079 2.67947 7.11294C2.11997 6.47551 1.8126 5.63599 1.8126 4.78826C1.8126 3.09829 3.12794 1.31944 5.28827 1.3126C7.2435 1.3126 8.81315 2.88226 8.81315 4.78826C8.81315 5.63599 8.50688 6.47551 7.94902 7.11267ZM4.87534 2.18767C3.66939 2.18767 2.68767 3.16939 2.68767 4.37534C2.68767 4.61719 2.88336 4.81288 3.12521 4.81288C3.36705 4.81288 3.56274 4.61599 3.56274 4.37534C3.56274 3.6515 4.1515 3.06274 4.87534 3.06274C5.11719 3.06274 5.31288 2.86727 5.31288 2.62548C5.31288 2.38369 5.11599 2.18767 4.87534 2.18767Z"></path>
              </svg>
            </div>}
          <div className="flex-1 text-sm prose text-wrap text-emerald-900 dark:text-emerald-200">
            {children}
          </div>
        </div>
      </div>}
    {variant === 'note' && <div className="my-4 px-5 py-4 overflow-hidden rounded-xl border border-sky-500/20 bg-sky-50/50 dark:border-sky-500/30 dark:bg-sky-500/10">
        <div className="flex items-start space-x-3">
          {icon && <div className="mt-0.5 w-4">
              <svg width="14" height="14" viewBox="0 0 14 14" fill="currentColor" xmlns="http://www.w3.org/2000/svg" className="w-4 h-4 text-sky-500" aria-label="CustomNote">
                <path fill-rule="evenodd" clip-rule="evenodd" d="M7 1.3C10.14 1.3 12.7 3.86 12.7 7C12.7 10.14 10.14 12.7 7 12.7C5.48908 12.6974 4.0408 12.096 2.97241 11.0276C1.90403 9.9592 1.30264 8.51092 1.3 7C1.3 3.86 3.86 1.3 7 1.3ZM7 0C3.14 0 0 3.14 0 7C0 10.86 3.14 14 7 14C10.86 14 14 10.86 14 7C14 3.14 10.86 0 7 0ZM8 3H6V8H8V3ZM8 9H6V11H8V9Z"></path>
              </svg>
            </div>}
          <div className="flex-1 text-sm prose text-wrap text-sky-900 dark:text-sky-200">
            {children}
          </div>
        </div>
      </div>}
    {variant === 'info' && <div className="my-4 px-5 py-4 overflow-hidden rounded-xl border border-zinc-500/20 bg-zinc-50/50 dark:border-zinc-500/30 dark:bg-zinc-500/10">
        <div className="flex items-start space-x-3">
          {icon && <div className="mt-0.5 w-4">
              <svg viewBox="0 0 20 20" fill="currentColor" xmlns="http://www.w3.org/2000/svg" className="flex-none w-5 h-5 text-zinc-400 dark:text-zinc-300" aria-label="CustomInfo">
                <path d="M8 0C3.58125 0 0 3.58125 0 8C0 12.4187 3.58125 16 8 16C12.4187 16 16 12.4187 16 8C16 3.58125 12.4187 0 8 0ZM8 14.5C4.41563 14.5 1.5 11.5841 1.5 8C1.5 4.41594 4.41563 1.5 8 1.5C11.5844 1.5 14.5 4.41594 14.5 8C14.5 11.5841 11.5844 14.5 8 14.5ZM9.25 10.5H8.75V7.75C8.75 7.3375 8.41563 7 8 7H7C6.5875 7 6.25 7.3375 6.25 7.75C6.25 8.1625 6.5875 8.5 7 8.5H7.25V10.5H6.75C6.3375 10.5 6 10.8375 6 11.25C6 11.6625 6.3375 12 6.75 12H9.25C9.66406 12 10 11.6641 10 11.25C10 10.8359 9.66563 10.5 9.25 10.5ZM8 6C8.55219 6 9 5.55219 9 5C9 4.44781 8.55219 4 8 4C7.44781 4 7 4.44687 7 5C7 5.55313 7.44687 6 8 6Z"></path>
              </svg>
            </div>}
          <div className="flex-1 text-sm prose text-wrap text-zinc-900 dark:text-zinc-200">
            {children}
          </div>
        </div>
      </div>}
    {variant === 'warning' && <div className="my-4 px-5 py-4 overflow-hidden rounded-xl border border-amber-500/20 bg-amber-50/50 dark:border-amber-500/30 dark:bg-amber-500/10">
        <div className="flex items-start space-x-3">
          {icon && <div className="mt-0.5 w-4">
              <svg className="flex-none w-5 h-5 text-amber-400 dark:text-amber-300/80" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" aria-label="CustomWarning">
                <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"></path>
              </svg>
            </div>}
          <div className="flex-1 text-sm prose text-wrap text-amber-900 dark:text-amber-200">
            {children}
          </div>
        </div>
      </div>}
    {variant === 'check' && <div className="my-4 px-5 py-4 overflow-hidden rounded-xl border border-emerald-500/20 bg-emerald-50/50 dark:border-emerald-500/30 dark:bg-emerald-500/10">
        <div className="flex items-start space-x-3">
          {icon && <div className="mt-0.5 w-4">
              <svg className="text-green-600 dark:text-green-400/80 w-3.5 h-auto" fill="currentColor" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512" aria-label="CustomCheck">
                <path d="M438.6 105.4C451.1 117.9 451.1 138.1 438.6 150.6L182.6 406.6C170.1 419.1 149.9 419.1 137.4 406.6L9.372 278.6C-3.124 266.1-3.124 245.9 9.372 233.4C21.87 220.9 42.13 220.9 54.63 233.4L159.1 338.7L393.4 105.4C405.9 92.88 426.1 92.88 438.6 105.4H438.6z"></path>
              </svg>
            </div>}
          <div className="flex-1 text-sm prose text-wrap text-emerald-900 dark:text-emerald-200">
            {children}
          </div>
        </div>
      </div>}
  </>;

export const ConciergeHero = ({children, subtitle, title}) => <div className="flex flex-col md:flex-row not-prose h-full md:min-h-80 md:h-full items-start w-full justify-evenly">
    <div className="flex flex-col justify-center  flex-1 px-6 sm:pl-6 pt-10 mt-3">
      <h1 style={{
  lineHeight: '1.25'
}} className="text-3xl tracking-wider font-semibold whitespace-nowrap flex-1 text-zinc-900 dark:text-zinc-200">
        {title}
      </h1>
      <p className="text-sm sm:text-xs leading-6 pt-4 tracking-tight">
        {subtitle}
      </p>
    </div>
    <div className="flex w-1/2 h-80 flex items-center pb-10 sm:pb-0">
      {children}
    </div>
  </div>;

export const HeroContent = ({children, withGrid}) => <div>
    <div className="not-prose relative bg-gray-50/50 rounded-xl overflow-hidden dark:bg-gray-800/25">
      {withGrid && <div className="absolute grid content-center inset-0 bg-grid-neutral-200/20 [mask-image:linear-gradient(0deg,#fff,rgba(255,255,255,0.6))] dark:bg-grid-white/5 dark:[mask-image:linear-gradient(0deg,rgba(255,255,255,0.1),rgba(255,255,255,0.5))]" style={{
  backgroundPosition: '10px 10px',
  color: '#070712'
}}></div>}
      <div className="relative rounded-xl overflow-hidden flex justify-center">{children}</div>
      <div className="absolute inset-0 pointer-events-none border border-black/5 rounded-xl dark:border-white/5"></div>
    </div>
  </div>;

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.

<Accordion title="Benefits">
  * **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.
</Accordion>

<Accordion title="Key Features">
  * **Automate Customer Intake:** Capture customer needs,
    must-have features, budget, and desired timeline all-in-one place.
  * **Access Concierge Network:** Connect to a network of high-end concierges to search and deliver to find the best deals and options.
  * **Seamless Negotiations:** Let a concierge agent take care of negotiations and driveway delivery.
</Accordion>

***

## 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.

<Accordion title="Quote Concierge Search">
  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.

  ```json Create Quote theme={null}
  {
    "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"
      }
    ]
  }
  ```

  ```json Example Response theme={null}
  {
    "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](#webhooks), ensuring timely updates throughout the search process.
</Accordion>

<Accordion title="Order Concierge Search">
  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.

  ```json Create Order theme={null}
  {
    "type": "concierge",
    "services": ["search"],
    "quoteId": "quote_x5f4d3"
  }
  ```

  ```json Example Response theme={null}
  {
    "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](#webhooks), ensuring you're always up-to-date on the progress of your vehicle search.
</Accordion>

### 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.

<Accordion title="Quote Concierge Buy">
  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.

  ```json theme={null}
  {
    "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"
      }
    ]
  }
  ```

  ```json theme={null}
  {
    "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](#webhooks), ensuring timely updates throughout the purchase process.
</Accordion>

<Accordion title="Order Concierge Buy">
  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.

  ```json theme={null}
  {
    "type": "concierge",
    "services": ["buy"],
    "quoteId": "quote_u3f4d3",
    "vin": "4T1B11HK0KU704570"
  }
  ```

  ```json theme={null}
  {
    "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](#webhooks), ensuring you're always up-to-date on the progress of your vehicle purchase.
</Accordion>

***

## 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](#webhooks).

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## Webhooks

`service.created` - This event is triggered when a service order is created, providing you with the details of the order:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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.

<CardGroup cols={2}>
  <Card icon="book" href="/services/reference/service-quote" title="Quote - Concierge">
    Quote concierge search and buy services
  </Card>

  <Card icon="book" href="/services/reference/service-order/create-a-new-service-order" title="Order - Concierge">
    Order concierge search and buy services
  </Card>
</CardGroup>