Overview

Vehicle Inspections are designed to help you make an informed decision about a vehicle before you purchase it. Inspections can help you identify potential problems with a vehicle that may not be immediately apparent, and they can give you peace of mind that you are making a good investment.

There are several types of vehicle inspections that you may encounter when buying or selling a vehicle.

  • Pre-Purchase: Identifies potential problems and provides repair cost estimates before you buy the vehicle.
  • Post-Purchase: Assesses the vehicle’s condition and identifies any issues that need to be addressed after purchase.
  • Safety: Identifies safety issues and ensures the vehicle is safe to drive.
  • Mechanical: Checks for mechanical issues and provides repair cost estimates.
  • Condition: Evaluates cosmetic issues and provides repair cost estimates.
  • Arbitration: Confirms the vehicle’s condition matches what was promised and identifies any issues that need to be addressed.

Workflows

The Inspections API facilitates two primary functions, Quote Inspection and Order Inspection for all inspection types.

Quote Inspection

To obtain a quote for inspection services, you will need to provide the following information:

Order Inspection

To create an order for scheduled maintenance services, you will need to provide the following information:


Typical Progression

Lets go over the typical progression of a inspection service order. While these steps are typical, there may be issues, delays, or other factors that can affect the progression of your service order.

If any problems arise, the service order’s status will be updated to either delayed or canceled, and you will be notified of the issue via email and webhook.

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 pick up the vehicle, and start work.

2

After some time has passed

The service provider will begin working on your vehicle, ensuring it receives the care it needs.

The service order will be updated to include the status of the service, moving from pending to in-progress.

3

Work is completed

Once the service is completed, the service order will be updated to reflect the status of the service.

After work is completed, the service order will be updated to include the status of the service, moving from in-progress to completed.


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": "inspection",
  "data": {
    "id": "order_hjKtntaEqMiSlD",
    "deal": "deal_TVKtntaEqMiS",
    "status": "pending", // pending, in-progress, completed, delayed, canceled
    "estimatedTime": "2024-01-01T12:00:00Z",
    "receiptLink": "https://checkout.driv.ly/order_hjKtntaEqMiSlD",
    "paid": true,
    "total": 69,
    "items": [
      {
        "service": "inspection",
        "price": 69,
        "name": "Pre-Purchase Inspection for WP0AF2A99KS165242",
        "description": "Pre-Purchase Inspection",
        "quantity": 1
      }
    ],
    "history": [
      // An Array to show the keys changed and when
      {
        "status": "pending",
        "paid": true,
        "time": "2024-01-01T12:00:00Z"
      }
    ]
  }
}

service.updated - This event is triggered when a service order is updated, in this case, when work is started on the inspection:

{
  "event": "service.updated",
  "type": "inspection",
  "data": {
    "id": "order_hjKtntaEqMiSlD",
    "deal": "deal_TVKtntaEqMiS",
    "status": "in-progress", // pending, in-progress, completed, delayed, canceled
    "estimatedTime": "2024-01-01T12:00:00Z",
    "receiptLink": "https://checkout.driv.ly/order_hjKtntaEqMiSlD",
    "paid": true,
    "total": 69,
    "items": [
      {
        "service": "inspection",
        "price": 69,
        "name": "Pre-Purchase Inspection for WP0AF2A99KS165242",
        "description": "Pre-Purchase Inspection",
        "quantity": 1
      }
    ],
    "history": [
      {
        "status": "pending",
        "paid": true,
        "time": "2024-01-01T12:00:00Z"
      },
      {
        "status": "in-progress",
        "time": "2024-01-02T12: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": "inspection",
  "data": {
    "id": "order_hjKtntaEqMiSlD",
    "deal": "deal_TVKtntaEqMiS",
    "status": "completed",
    "result": {
      // Once complete, the service order will have a result object
      // For inspections, this is a link to the inspection report
      "reportLink": "https://reports.driv.ly/report_vcHQHVhqnrQFZ"
    },
    "estimatedTime": null,
    "receiptLink": "https://checkout.driv.ly/order_hjKtntaEqMiSlD",
    "paid": true,
    "total": 69,
    "items": [
      {
        "service": "inspection",
        "price": 69,
        "name": "Pre-Purchase Inspection for WP0AF2A99KS165242",
        "description": "Pre-Purchase Inspection",
        "quantity": 1
      }
    ],
    "history": [
      {
        "status": "pending",
        "paid": true,
        "time": "2024-01-01T12:00:00Z"
      },
      {
        "status": "in-progress",
        "time": "2024-01-02T12:00:00Z"
      },
      {
        "status": "completed",
        "time": "2024-01-03T12:00:00Z"
      }
    ]
  }
}

Inspection Report

Once the inspection is completed, you will receive a link to the vehicle inspection report. This report will contain detailed information about the condition of the vehicle, including any issues that were found during the inspection:


Next Steps

Ready to get started with Inspections API?