​
Overview

Drivly’s Title & Registration API simplifies the complex process of managing vehicle titles and registrations, offering a straightforward solution for obtaining quotes and placing orders.

​
Workflows

The API provides facilitate two primary functions, Quote and Order title and registration services.

​
Quote Title & Registration

Obtain accurate quotes for complete title and registration, title transfers, registration renewals, and duplicate titles.

​
Order Title & Registration

Place orders for title and registration services, ensuring vehicles are properly registered and compliant with state regulations.

​
Typical Progression

Lets go over the typical progression of a title and registration 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": "title-&-registration",
  "data": {
    "id": "order_PUjabSbTExm1Ac",
    "dealId": "deal_1a2b3c4d5e",
    "status": "pending", // pending, in-progress, completed, delayed, canceled
    "estimatedTime": "2024-01-01T12:00:00Z",
    "receiptLink": "https://checkout.driv.ly/order_PUjabSbTExm1Ac",
    "paid": true,
    "total": 130,
    "items": [
      {
        "service": "title-&-registration",
        "price": 40,
        "name": "Title Transfer for WP0AF2A99KS165242",
        "description": "title transfer",
        "quantity": 1
      },
      {
        "service": "title-&-registration",
        "price": 90,
        "name": "Registration Renewal for WP0AF2A99KS165242",
        "description": "registration renewal",
        "quantity": 1
      }
    ],
    "history": [
      {
        "status": "pending",
        "paid": true,
        "timestamp": "2024-01-01T12:00:00Z"
      }
    ]
  }
}

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

{
  "event": "service.updated",
  "type": "title-&-registration",
  "data": {
    "id": "order_PUjabSbTExm1Ac",
    "dealId": "deal_1a2b3c4d5e",
    "status": "in-progress",
    "estimatedTime": "2024-01-01T12:00:00Z",
    "receiptLink": "https://checkout.driv.ly/order_PUjabSbTExm1Ac",
    "paid": true,
    "total": 130,
    "items": [
      {
        "service": "title-&-registration",
        "price": 40,
        "name": "Title Transfer for WP0AF2A99KS165242",
        "description": "title transfer",
        "quantity": 1
      },
      {
        "service": "title-&-registration",
        "price": 90,
        "name": "Registration Renewal for WP0AF2A99KS165242",
        "description": "registration renewal",
        "quantity": 1
      }
    ],
    "history": [
      {
        "status": "pending",
        "paid": true,
        "timestamp": "2024-01-01T12:00:00Z"
      },
      {
        "status": "in-progress",
        "timestamp": "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": "title-&-registration",
  "data": {
    "id": "order_PUjabSbTExm1Ac",
    "dealId": "deal_1a2b3c4d5e",
    "status": "completed",
    "estimatedTime": "2024-01-01T12:00:00Z",
    "receiptLink": "https://checkout.driv.ly/order_PUjabSbTExm1Ac",
    "paid": true,
    "total": 130,
    "items": [
      {
        "service": "title-&-registration",
        "price": 40,
        "name": "Title Transfer for WP0AF2A99KS165242",
        "description": "title transfer",
        "quantity": 1
      },
      {
        "service": "title-&-registration",
        "price": 90,
        "name": "Registration Renewal for WP0AF2A99KS165242",
        "description": "registration renewal",
        "quantity": 1
      }
    ],
    "history": [
      {
        "status": "pending",
        "paid": true,
        "timestamp": "2024-01-01T12:00:00Z"
      },
      {
        "status": "in-progress",
        "timestamp": "2024-01-02T12:00:00Z"
      },
      {
        "status": "completed",
        "timestamp": "2024-01-03T12:00:00Z"
      }
    ]
  }
}

​
Next Steps

Ready to get started with Title & Registration API?

Quote – Title & Registration

Quote title and registration services

Order – Title & Registration

Order title and registration services