POST
/
api
/
calculate-safety-score

Calculate a driver's safety score using MVR and optional PSP documents.

Request Format

The API accepts a JSON request with the following structure:

Field Type Description Required
mvrFile String (base64) Base64-encoded MVR (Motor Vehicle Record) document Yes
pspFile String (base64) Base64-encoded PSP (Pre-employment Screening Program) document No
cdlData Object CDL information including fullName, licenseNumber, dateOfBirth, etc. No

cdlData Object Structure

The API accepts a JSON request with the following structure:

Field Type Description Required
fullName String Full name of the driver Yes
licenseNumber String CDL license number Yes
dateOfBirth String (YYYY-MM-DD) Driver's date of birth No
issueDate String (YYYY-MM-DD) License issue date No
expiryDate String (YYYY-MM-DD) License expiry date No
classType String CDL class type (A, B, or C) Yes
licenseState String State that issued the license Yes

Response Format

The API returns a JSON response with processing results and safety score data:

{
"status": "true",
 "mvrData": 
{
  "driverName": "John Doe",
  "licenseNumber": "DL123456789",
  "dateOfBirth": "1980-01-01",
  "classType": "A",
  "licenseState": "TX",
  "otherViolations": [...],
  "crashViolations": [...],
  "suspensions": {...},
}
"pspData": 
{
  "driverName": "John Doe",
  "licenseNumber": "DL123456789",
  "dateOfBirth": "1980-01-01",
  "licenseState": "TX",
  "crashes": {...},
  "inspections": {...},
}
"safetyResults": 
  {
    "safetyScore": 85,
    "scoreCalculation": {...},
    "driverExperience": {...},
    "violations": [...],
    "statistics": {...},
    "accidents": [...],
    "cleanInspections": [...],
    "groupedViolations": {...},
    "eligibility": {...},
  }
}

Error Format

The API returns a JSON response with processing errors or validation failures

{
"status": "false",
"error": "Invalid request data",
"details": [
  {
    "code": "invalid_type",
    "expected": "string",
    "received: "undefined",
    "path": ["mvrFile"],
    "message": "Required",
  }
  ]
}

Was this page helpful?

Suggest edits Raise issue