🚛 SaferCarrier API Documentation

Complete API reference for FMCSA carrier data

Base URL: http://api.safercarrier.com

Carriers

GET /api/carriers/

List all carriers (paginated)

Parameters
Name Type Description
search string Search by DOT, MC, or company name
page integer Page number
Example Request
http://api.safercarrier.com/api/carriers/?search=DENEX&page=1
Sample Response
{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "dot_number": "4548086",
      "mc_number": "1805871",
      "legal_name": "CHEETEX LLC",
      "phone": "3478990027",
      "email": "INFO@CHEETEX.COM",
      "phy_city": "HAINES CITY",
      "phy_state": "FL",
      "operating_status": null,
      "power_units": 1,
      "total_drivers": 1
    }
  ]
}
GET /api/carriers/{dot_number}/

Get detailed carrier information by DOT number

Example Request
http://api.safercarrier.com/api/carriers/4108577/
Sample Response
{
  "dot_number": "4548086",
  "mc_number": "1805871",
  "legal_name": "CHEETEX LLC",
  "dba_name": null,
  "phone": "3478990027",
  "email": "INFO@CHEETEX.COM",
  "phy_street": "5722 SOMERSET DR",
  "phy_city": "HAINES CITY",
  "phy_state": "FL",
  "phy_zip": "33844",
  "operating_status": null,
  "power_units": 1,
  "total_drivers": 1
}
GET /api/carriers/{id}/inspections/

Get all inspections for a specific carrier from local database

Example Request
http://api.safercarrier.com/api/carriers/33/inspections/
Sample Response
{
  "results": [
    {
      "inspection_id": "82260304",
      "inspection_date": "2024-07-25"
    }
  ]
}
GET /api/carriers/{id}/fmcsa_inspections/

Get inspections for a carrier directly from FMCSA API

Parameters
Name Type Description
limit integer Number of results (default 20)
Example Request
http://api.safercarrier.com/api/carriers/33/fmcsa_inspections/?limit=20
Sample Response
{
  "results": []
}
GET /api/carriers/{id}/crashes/

Get all crashes for a specific carrier from local database

Example Request
http://api.safercarrier.com/api/carriers/33/crashes/
Sample Response
{
  "results": []
}
GET /api/carriers/{id}/fmcsa_crashes/

Get crashes for a carrier directly from FMCSA API

Parameters
Name Type Description
limit integer Number of results (default 20)
Example Request
http://api.safercarrier.com/api/carriers/33/fmcsa_crashes/?limit=20
Sample Response
{
  "results": []
}
GET /api/carriers/{id}/sms_scores/

Get SMS BASIC scores for a carrier from FMCSA API

Example Request
http://api.safercarrier.com/api/carriers/33/sms_scores/
Sample Response
{
  "basics": {
    "unsafe_driving": {
      "percentile": 50
    }
  }
}
GET /api/carriers/{id}/associated_entities/

Find carriers associated through shared phone/email/officers

Example Request
http://api.safercarrier.com/api/carriers/33/associated_entities/
Sample Response
{
  "results": []
}
GET /api/carriers/{id}/insurance_history/

Get insurance filing history from FMCSA InsHist dataset

Example Request
http://api.safercarrier.com/api/carriers/33/insurance_history/
Sample Response
{
  "history": []
}
GET /api/carriers/{id}/current_insurance/

Get current active insurance policies

Example Request
http://api.safercarrier.com/api/carriers/33/current_insurance/
Sample Response
{
  "policies": []
}
GET /api/carriers/verify_contact/

Verify contact by searching phone or email across all carriers

Parameters
Name Type Description
phone string Phone number to search
email string Email address to search
Example Request
http://api.safercarrier.com/api/carriers/verify_contact/?phone=3212038928
Sample Response
{
  "results": [
    {
      "dot_number": "4108577",
      "legal_name": "DENEX LLC"
    }
  ]
}
GET /api/carriers/fmcsa_lookup/

Fetch carrier data directly from FMCSA API by DOT or MC

Parameters
Name Type Description
dot string DOT Number
mc string MC Number
Example Request
http://api.safercarrier.com/api/carriers/fmcsa_lookup/?dot=4108577
Sample Response
{
  "dot_number": "4108577",
  "legal_name": "DENEX LLC"
}
POST /api/carriers/import_from_fmcsa/

Import/update a carrier from FMCSA and save to local database

Parameters
Name Type Description
dot_number string DOT Number
mc_number string MC Number
Example Request
http://api.safercarrier.com/api/carriers/import_from_fmcsa/ (POST with dot_number in body)
Sample Response
{
  "message": "Carrier imported successfully"
}
GET /api/carriers/search_fmcsa_by_name/

Search FMCSA database by company name

Parameters
Name Type Description
name string Company name to search
Example Request
http://api.safercarrier.com/api/carriers/search_fmcsa_by_name/?name=DENEX
Sample Response
{
  "results": []
}
GET /api/carriers/search_fmcsa/

Universal FMCSA search - detects search type (DOT/MC/Name/Phone/Email)

Parameters
Name Type Description
q string Search query
Example Request
http://api.safercarrier.com/api/carriers/search_fmcsa/?q=4108577
Sample Response
{
  "results": []
}

Inspections

GET /api/inspections/

List all inspections (paginated)

Parameters
Name Type Description
dot_number string Filter by DOT number
page integer Page number
Example Request
http://api.safercarrier.com/api/inspections/?dot_number=4108577
Sample Response
{
  "count": 10,
  "results": [
    {
      "inspection_id": "82260304",
      "carrier": "4108577",
      "inspection_date": "2024-07-25",
      "report_state": "TN",
      "report_number": "I034BE0004",
      "inspection_level": "3",
      "total_violations": 0,
      "total_oos": 0
    }
  ]
}
GET /api/inspections/{inspection_id}/

Get detailed inspection by ID

Example Request
http://api.safercarrier.com/api/inspections/82260304/
Sample Response
{
  "inspection_id": "82260304",
  "carrier": "4108577",
  "inspection_date": "2024-07-25",
  "violations": []
}
GET /api/inspections/fmcsa_details/

Get inspection details with violations from FMCSA API

Parameters
Name Type Description
inspection_id string Inspection ID
Example Request
http://api.safercarrier.com/api/inspections/fmcsa_details/?inspection_id=82260304
Sample Response
{
  "inspection": {},
  "violations": []
}

Crashes

GET /api/crashes/

List all crashes (paginated)

Parameters
Name Type Description
dot_number string Filter by DOT number
page integer Page number
Example Request
http://api.safercarrier.com/api/crashes/?dot_number=4108577
Sample Response
{
  "count": 5,
  "results": [
    {
      "crash_id": "12345",
      "carrier": "4108577",
      "report_date": "2024-01-15",
      "report_state": "FL",
      "fatalities": 0,
      "injuries": 1,
      "tow_away": true
    }
  ]
}
GET /api/crashes/fmcsa_details/

Get crash details from FMCSA API by crash_id

Parameters
Name Type Description
crash_id string Crash ID
Example Request
http://api.safercarrier.com/api/crashes/fmcsa_details/?crash_id=12345
Sample Response
{
  "crash": {},
  "details": {}
}

Authority History

GET /api/authority-history/

List authority history records

Parameters
Name Type Description
dot_number string Filter by DOT number
Example Request
http://api.safercarrier.com/api/authority-history/?dot_number=4108577
Sample Response
{
  "results": [
    {
      "dot_number": "4108577",
      "authority_type": "MOTOR CARRIER",
      "authority_status": "ACTIVE",
      "effective_date": "2023-07-26"
    }
  ]
}

BOC-3 Process Agents

GET /api/boc3/

List BOC-3 process agents

Parameters
Name Type Description
dot_number string Filter by DOT number
Example Request
http://api.safercarrier.com/api/boc3/?dot_number=4108577
Sample Response
{
  "results": [
    {
      "dot_number": "4108577",
      "agent_name": "ABC Process Service",
      "agent_state": "FL",
      "agent_city": "Miami"
    }
  ]
}