Skip to main content

Create Driver Profile

Body Parameters

userId
string
required
UUID of the user account to associate with this driver profile
driverLicenseNumber
string
required
Driver license number (1-50 characters, must be unique)
driverLicenseExpirationDate
string
required
License expiration date in ISO 8601 format
driverLicensePictureUrl
string
URL to the driver license image
backgroundCheckStatus
enum
Background check status. Defaults to pending_background_check
  • pending_background_check
  • approved
  • rejected
backgroundCheckDate
string
Date when background check was performed (ISO 8601)
isApproved
boolean
Whether the driver is approved to operate. Defaults to false
emergencyContactInfo
object
Emergency contact information
driverStatus
enum
Operational status of the driver. Defaults to pending_docs
  • active - Approved and actively driving
  • suspended - Temporarily suspended
  • on_vacation - On vacation
  • pending_docs - Awaiting documentation
  • deactivated - Account deactivated
paidPriorityUntil
string
Date until which the driver has paid priority status (ISO 8601)
initialVehicle
object
Optional vehicle to create alongside the driver profile during onboarding

Response

success
boolean
Indicates if the operation was successful
message
string
Response message
data
object
Created driver profile

List Driver Profiles

Query Parameters

page
number
default:"1"
Page number for pagination
limit
number
default:"10"
Number of items per page
userId
string
Filter by user UUID
driverLicenseNumber
string
Filter by driver license number (1-50 characters)
backgroundCheckStatus
enum
Filter by background check status
  • pending_background_check
  • approved
  • rejected
isApproved
boolean
Filter by approval status
driverStatus
enum
Filter by driver operational status
  • active
  • suspended
  • on_vacation
  • pending_docs
  • deactivated

Response

success
boolean
Indicates if the operation was successful
message
string
Response message
data
array
Array of driver profiles
meta
object
Pagination metadata

Get Driver Profile

Path Parameters

id
string
required
UUID of the driver profile

Response

success
boolean
Indicates if the operation was successful
message
string
Response message
data
object
Driver profile details

Update Driver Profile

Path Parameters

id
string
required
UUID of the driver profile to update

Body Parameters

driverLicenseNumber
string
New driver license number (1-50 characters)
driverLicenseExpirationDate
string
New license expiration date (ISO 8601)
driverLicensePictureUrl
string
New URL to driver license image
emergencyContactInfo
object
Updated emergency contact information
driverStatus
enum
New operational status
  • active
  • suspended
  • on_vacation
  • pending_docs
  • deactivated
paidPriorityUntil
string
New paid priority expiration date (ISO 8601)
backgroundCheckStatus
enum
New background check status
  • pending_background_check
  • approved
  • rejected
backgroundCheckDate
string
New background check date (ISO 8601)
isApproved
boolean
Updated approval status

Response

success
boolean
Indicates if the operation was successful
message
string
Response message
data
object
Updated driver profile

Delete Driver Profile

Path Parameters

id
string
required
UUID of the driver profile to delete

Response

success
boolean
Indicates if the operation was successful
message
string
Response message
data
null
Returns null for deleted resources

Build docs developers (and LLMs) love