Skip to main content

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.

Types of Inspections

  • 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:
A quote is used to pass the cost to the customer, and to allow them to pay for the service. The quote will return with a checkout link, which you should redirect the customer towards. Once the customer has paid, a service order will be created with the details of the quote.
Attaching a deal to a quote will allow you to track all services related to that specific deal. The final invoice for the deal will include this quote, but will state that it was paid for separately.
Create Quote
{
  "type": "inspection",
  "services": ["pre-purchase"], // post-purchase, safety, mechanical, condition, arbitration
  "vin": "WP0AF2A99KS165242",
  "deal": "deal_TVKtntaEqMiS" // Optional, but recommended
}
Example Response
{
  "id": "quote_sf7Y7c",
  "deal": "deal_TVKtntaEqMiS", // Null if not provided
  "estimatedTime": null,
  "checkoutLink": "https://checkout.driv.ly/quote_sf7Y7c",
  "paid": false,
  "total": 69,
  "items": [
    {
      "service": "inspection",
      "price": 69,
      "name": "Pre-Purchase Inspection for WP0AF2A99KS165242",
      "description": "Pre-Purchase Inspection",
      "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 inspection process.

Order Inspection

To create an order for scheduled maintenance services, you will need to provide the following information:
Creating an order allows you to programatically schedule, and pay for a inspection. This will create a service order, which will be updated as the inspection progresses.While you can request a quote for scheduled maintenance services, its not recommended because it relies on the customer to pay for the service. Instead, its recommended to create an order and pay for the service directly, then request payment at a later date.
For service orders, attaching a deal is highly recommended as this will allow you to keep all pending invoices in one place. The final invoice for the deal will include this order, but is rolled up into the total cost of the deal.
Create Order
{
  "type": "inspection",
  "services": ["mechanical"], // post-purchase, safety, mechanical, condition, arbitration
  "vin": "WP0AF2A99KS165242",
  "deal": "deal_TVKtntaEqMiS" // Optional, but recommended
}
Example Response
{
  "id": "order_hjKtntaEqMiSlD",
  "deal": "deal_TVKtntaEqMiS", // Null if not provided
  "status": "pending",
  "estimatedTime": "2024-01-01T12:00:00Z",
  "receiptLink": "https://checkout.driv.ly/order_hjKtntaEqMiSlD",
  "paid": true, // Will always be true for orders
  "total": 252,
  "items": [
    {
      "service": "inspection",
      "price": 252,
      "name": "Mechanical Inspection for WP0AF2A99KS165242",
      "description": "Mechanical Inspection",
      "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’s inspection.

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:
{
  "data": {
    "id": "report_vcHQHVhqnrQFZ",
    "vin": "WP0AF2A99KS165242",
    "vehicleType": "standard",
    "mileage": 12345,
    "photos": [
      "https://cdn.photos.vin/detail/WP0AF2A99KS165242/1.jpg",
      "https://cdn.photos.vin/detail/WP0AF2A99KS165242/2.jpg",
      "https://cdn.photos.vin/detail/WP0AF2A99KS165242/3.jpg",
      ...
    ],
    "exterior": {
      "Back-Up Camera": {
        "passed": true,
        "notes": null
      },
      "Wiper Blades": {
        "passed": true,
        "notes": null
      },
      "Windshield Washer": {
        "passed": false,
        "notes": "The windshield washer fluid was low. Did not see work."
      },
      "Body Alignment": {
        "passed": false,
        "notes": "The right front fender to right front door is slightly off."
      },
      "Scratches": {
        "passed": false,
        "notes": "There are scratches throughout the entire vehicle."
      },
      "Dings": {
        "passed": false,
        "notes": "There are dings throughout the vehicle."
      },
      "Dents": {
        "passed": false,
        "notes": "There are dents on the right front fender and door."
      },
      "Paint Condition": {
        "passed": true,
        "notes": null
      },
      "Rust": {
        "passed": true,
        "notes": null
      },
      "Exterior Lights": {
        "passed": false,
        "notes": "There are scratches and chips on the front lights with a crack in the right front head light. There are scratches on the rear lights."
      },
      "Sunroof": {
        "passed": true,
        "notes": null
      },
      "Door Mirrors": {
        "passed": false,
        "notes": "The left mirror has rock chips."
      },
      "Bumpers": {
        "passed": false,
        "notes": "The front cover shows signs of impact on the left front. Both have scratches."
      },
      "Side Moldings": {
        "passed": true,
        "notes": null
      },
      "Frame Damage": {
        "passed": false,
        "notes": "The leading edge of the left front rocker is pushed in. Disassembly required for further evaluation."
      },
      "Glass": {
        "passed": false,
        "notes": "There are two rock chips on the front wind shield."
      },
      "Body Seals": {
        "passed": true,
        "notes": null
      }
    },
    "interior": {
      "Steering Wheel": {
        "passed": false,
        "notes": "The wheel is worn."
      },
      "Horn": {
        "passed": true,
        "notes": null
      },
      "Cruise Control": {
        "passed": true,
        "notes": null
      },
      "Seat Condition": {
        "passed": false,
        "notes": "The driver seat is worn on upper outer bolster."
      },
      "Heated Seats": {
        "passed": true,
        "notes": null
      },
      "Seat Belts": {
        "passed": true,
        "notes": null
      },
      "Clock": {
        "passed": true,
        "notes": null
      },
      "Radio/Navigation": {
        "passed": false,
        "notes": "The volume knob works inconsistently."
      },
      "Inner Door Panels": {
        "passed": true,
        "notes": null
      },
      "Power Locks": {
        "passed": true,
        "notes": null
      },
      "Window Switches": {
        "passed": true,
        "notes": null
      },
      "Window Function": {
        "passed": false,
        "notes": "The left front window screeches during operation."
      },
      "Center Console": {
        "passed": false,
        "notes": "The media select button is missing its trim. There are scratches and signs of use throughout this area."
      },
      "Dash": {
        "passed": true,
        "notes": null
      },
      "Sun Visors": {
        "passed": false,
        "notes": "Both visor retainer clips are broken."
      },
      "Dash Lights": {
        "passed": true,
        "notes": null
      },
      "Dash Gauges": {
        "passed": true,
        "notes": null
      },
      "Air Conditioning": {
        "passed": true,
        "notes": null
      },
      "Heater": {
        "passed": true,
        "notes": null
      },
      "Rear Defroster": {
        "passed": true,
        "notes": null
      },
      "Carpet": {
        "passed": true,
        "notes": null
      },
      "Floor Mats": {
        "passed": true,
        "notes": null
      },
      "Cigarette Use": {
        "passed": false,
        "notes": "The presence of cigarette use is strongly apparent."
      },
      "Unusual Odors": {
        "passed": true,
        "notes": null
      },
      "Cup Holders": {
        "passed": true,
        "notes": null
      },
      "Headliner": {
        "passed": true,
        "notes": null
      },
      "Blower Motor": {
        "passed": true,
        "notes": null
      },
      "Interior Trim": {
        "passed": true,
        "notes": null
      }
    },
    "mechanical": {
      "Air Filter": {
        "passed": true,
        "notes": null
      },
      "Battery Condition": {
        "passed": true,
        "notes": null
      },
      "Charging System": {
        "passed": true,
        "notes": null
      },
      "Cooling Fan Condition": {
        "passed": true,
        "notes": null
      },
      "Radiator Cap Sealing": {
        "passed": true,
        "notes": null
      },
      "Hoses": {
        "passed": true,
        "notes": null
      },
      "Radiator": {
        "passed": true,
        "notes": null
      },
      "Engine Coolant": {
        "passed": false,
        "notes": "Engine coolant should be replaced and system flushed."
      },
      "Coolant Leaks": {
        "passed": false,
        "notes": "I found water under the oil fill cap and unsure of where the water came from. It could be a coolant leak within the engine but there were no signs of intermix. It could also be water from pressure washing."
      },
      "Belts": {
        "passed": true,
        "notes": null
      },
      "Power Steering": {
        "passed": true,
        "notes": null
      },
      "Engine Oil": {
        "passed": false,
        "notes": "I found water under the oil fill cap. Draining of oil required to fully determine its source."
      },
      "Engine Fluid Leaks": {
        "passed": true,
        "notes": null
      },
      "Transmission Leaks": {
        "passed": true,
        "notes": null
      },
      "Brake System": {
        "passed": true,
        "notes": null
      },
      "Brake Fluid Leaks": {
        "passed": true,
        "notes": null
      },
      "Transfer Case Leaks": {
        "passed": true,
        "notes": null
      },
      "Differential Leaks": {
        "passed": true,
        "notes": null
      },
      "Muffler System": {
        "passed": true,
        "notes": null
      },
      "CV Joints and Axles": {
        "passed": true,
        "notes": null
      },
      "Shocks and Bushings": {
        "passed": true,
        "notes": null
      },
      "Ball Joints and Tie Rods": {
        "passed": true,
        "notes": null
      },
      "Key Fob": {
        "passed": true,
        "notes": null
      }
    }
  }
}

Next Steps

Ready to get started with Inspections API?
I