Carrier Observation

Exclusive access. This endpoint is only available to insurance customers. Contact your Customer Success Manager or GenLogs point of contact to request access.

The Carrier Observation API provides carrier information based on sightings in the GenLogs Sensor network, FMCSA Inspection Data, and other observation data as available.

This information can help assess risk profiles, verify carrier operations, determine territory pricing, make informed underwriting decisions, and more.

Authentication

Include the following headers in your requests:

• Access-Token: The access token obtained from the "Create Acess Token" endpoint.

• x-api-key: The API key provided by Genlogs. This header must be included in the request.

Endpoint

• URL: https://api.genlogs.io/visual_sightings/carrier-observations

• Method: GET

Query Parameters

• usdot_number (string, Required): usdot for a specific carrier.

• location_city (string, Optional): city where data was captured.

• location_state (string, Optional): state where data was captured.

• sighting_start_date (string, Optional): start date to make query.

• sighting_end_date (string, Optional): end date to make query.

Response

• 200 OK: A JSON object containing the message verified true or false

• 400 Bad Request: If required parameters are missing or invalid.

• 401 Unauthorized: If the authentication credentials (email and password) are missing or incorrect.

• 403 Forbidden: Access to the requested resource is forbidden.

• 500 Internal Server Error: If there is an issue on the server that prevents processing the request.

Response Body:

• fmcsa_detail (array of FMCSA objects): Detail about the carrier in the search.

  • usdot_number: (string) The USDOT number for the carrier.

  • docket_number: (string) The Motor Carrier number for carriers involved in interstate.

  • legal_name: (string) The official registered name of the carrier.

  • dba_name: (string) The "Doing Business As" name, if applicable.

  • carrier_status: (string) Indicates whether the carrier is active, inactive, or has a pending status.

  • entity_status: (string) Refers to the legal standing of the carrier's business entity.

  • carrier_ein: (string) It is a unique nine-digit number assigned by the IRS to identify the carrier for tax purposes.

  • dun_bradstreet_no: (string) It is a unique identifier assigned by Dun & Bradstreet to businesses.

  • mcs150_date: (string) The date when the carrier last updated their MCS-150 form (Motor Carrier Identification Report).

  • mcs150_mileage: (string) The total mileage reported by the carrier on their MCS-150 form, typically for the previous year.

  • insurer_company_name: (string) The name of the insurance company providing coverage for the carrier.

  • insurance_docket_number: (string) A unique identifier for the insurance filing associated with the carrier.

  • insurance_policy_number: (string) The policy number assigned by the insurer to the carrier's insurance policy.

  • insurance_policy_type: (string) Specifies the type of insurance policy (e.g., liability, cargo, etc.).

  • insurance_form_code: (string) A code representing the type of insurance form filed (e.g., BMC-91 for liability insurance).

  • insurance_max_coverage_amount: (string) The maximum coverage amount provided by the insurance policy.

  • insurance_underlying_limit_amount: (string) The underlying limit amount, which is the base coverage before additional layers of insurance apply.

  • insurance_transaction_date: (string) The date when the insurance transaction (e.g., filing or update) was processed.

  • insurance_effective_date: (string) The start date of the insurance policy.

  • insurance_expiration_date: (string) The end date of the insurance policy.

  • phy_street: (string) The street address of the carrier's physical location.

  • phy_city: (string) The city where the carrier's physical address is located.

  • phy_state: (string) The state where the carrier's physical address is located.

  • phy_zip: (string) The ZIP code for the carrier's physical address.

  • telephone: (string) The carrier's primary contact phone number.

  • email_address: (string) The carrier's email address for communication.

  • mailing_street: (string) The street address of the carrier's mailing location.

  • mailing_city: (string) The city where the carrier's mailing address is located.

  • mailing_state: (string) The state where the carrier's mailing address is located.

  • mailing_zip: (string) The ZIP code for the carrier's mailing address.

  • mailing_country: (string) The country of the carrier's mailing address.

  • carrier_operation: (string) Describes the type of operations the carrier is authorized to perform (e.g., interstate, intrastate, hazardous materials).

  • operation_classificiation: (string) Specifies the classification of the carrier's operations, such as for-hire, private, exempt, or passenger.

  • authority_date: (string) The date when the carrier's operating authority was granted.

  • authorized_for_common_date: (string) The date when the carrier was authorized for common carrier operations.

  • authorized_for_contract_date: (string) The date when the carrier was authorized for contract carrier operations.

  • carrier_total_drivers: (string) The total number of drivers employed by the carrier.

  • carrier_total_power_units: (string) The total number of power units (e.g., trucks, tractors) operated by the carrier.

  • carried_cargo: (string) The types of cargo the carrier is authorized to transport (e.g., general freight, hazardous materials).

  • carrier_driver_insp: (string) The total number of driver inspections conducted for the carrier.

  • carrier_driver_oos_insp: (string) The number of driver inspections that resulted in an out-of-service (OOS) order.

  • carrier_driver_oos_rate: (number) The percentage of driver inspections that resulted in an OOS order.

  • carrier_driver_oos_rate_national_avg: (number) The national average OOS rate for drivers, used for comparison.

  • carrier_vehicle_insp: (string) The total number of vehicle inspections conducted for the carrier.

  • carrier_vehicle_oos_insp: (string) The number of vehicle inspections that resulted in an OOS order.

  • carrier_vehicle_oos_rate: (number) The percentage of vehicle inspections that resulted in an OOS order.

  • carrier_vehicle_oos_rate_national_avg: (number) The national average OOS rate for vehicles, used for comparison.

  • carrier_hazmat_insp: (string) The total number of hazardous materials inspections conducted for the carrier.

  • carrier_hazmat_oos_insp: (string) The number of hazardous materials inspections that resulted in an OOS order.

  • carrier_hazmat_oos_rate: (number) The percentage of hazardous materials inspections that resulted in an OOS order.

  • carrier_hazmat_oos_rate_national_avg: (number) The national average OOS rate for hazardous materials, used for comparison.

  • carrier_fatal_crash: (string) The total number of fatal crashes involving the carrier.

  • carrier_inj_crash: (string) The total number of crashes involving injuries for the carrier.

  • carrier_towaway_crash: (string) The total number of crashes involving towaways for the carrier.

  • carrier_crash_total: (string) The total number of crashes involving the carrier, including all types of crashes (fatal, injury, and towaway).

  • recordable_crash_rate: (number) The rate of recordable crashes per million vehicle miles traveled (VMT). This metric helps assess the carrier's safety performance.

  • basic_unsafe_driving_total_violation: (string) The total number of violations related to unsafe driving (e.g., speeding, reckless driving) recorded for the carrier.

  • basic_driver_fitness_total_violation: (string) The total number of violations related to driver fitness (e.g., invalid licenses, medical qualifications).

  • basic_hos_total_violation: (string) The total number of violations related to Hours of Service (HOS) compliance (e.g., exceeding driving time limits, falsifying logs).

  • basic_drugs_alcohol_total_violation: (string) The total number of violations related to drug and alcohol use by drivers.

  • basic_vehicle_maint_total_violation: (string) The total number of violations related to vehicle maintenance (e.g., brake issues, lighting problems).

  • carrier_safety_rating_date: (string) The date when the carrier's most recent safety rating was issued.

  • carrier_safety_rating: (string)

    The carrier's safety rating, which can be one of the following:

    • Satisfactory: Meets safety standards.

    • Conditional: Does not meet all safety standards but is allowed to operate.

    • Unsatisfactory: Fails to meet safety standards and is not allowed to operate.

  • carrier_safety_review_date: (string) The date when the carrier's most recent safety review was conducted.

  • carrier_safety_review_type: (string) The type of safety review conducted (e.g., compliance review, safety audit).

• observations (array of Observations objects): List of observations for the search.

  • alpr_plate_number: (string) License plate number captured by ALPR.

  • usdot_number: (string) The USDOT number for the carrier.

  • time_captured: (string) The timestamp when the data was captured.

  • mc_number: (string) Motor Carrier number for the carrier.

  • vin: (string) Vehicle Identification Number.

  • cab_number: (string) Cab number.

  • equipment_type: (string). Type of equipment. Ie (Reefer, dryvan, etc.)

  • equipment_number: (string). Number of the equipment.

  • equipment_logo: (string) The logo of the trailer company.

  • location_city: (string) City or county where the observation occurred. If observation is from FMCSA, it would be county. Otherwise will be a city.

  • location_state: (string) State where the observation occurred.

  • latitude: (number), Latitude of the location where the observation occurred.

  • longitude: (number) , Longitude of the location where the observation occurred.

  • route: (string) Route and direction of travel.

  • source: (string) Source of the observation.

Request Example:

curl -X GET 'https://api.genlogs.io/visual_sightings/carrier-observations?usdot_number=3481976&location_city=enfield&location_state=NC' \
-H 'Access-Token: {access_token}' \
-H 'x-api-key: {your_api_key}' \
-i

Carrier Observation for access carrier sightings and operational insights

get

Query parameters

usdot_numberstringrequired

USDOT number to filter data for a specific carrier

location_cityany of · default: ""

Filter by city where data was captured

location_stateany of · default: ""

Filter by state where data was captured

sighting_start_dateany of · default: ""

Filter by start date

sighting_end_dateany of · default: ""

Filter by end date

Header parameters

acceptstring · default: "application/json"required

Specifies the format of the response.

Example: application/json

Access-Tokenstringrequired

Access Token for authentication

Example: [Token]

x-api-keystringrequired

API key for authentication

Example: [x-api-key]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.genlogs.io/visual_sightings/carrier-observations?usdot_number=text' \
  --header 'accept: application/json' \
  --header 'Access-Token: [Token]' \
  --header 'x-api-key: [x-api-key]'

200

200

{
  "data": {
    "fmcsa_detail": [
      {
        "usdot_number": "text",
        "docket_number": "text",
        "legal_name": "text",
        "dba_name": "text",
        "carrier_status": "text",
        "entity_type": "text",
        "carrier_ein": "text",
        "dun_bradstreet_no": "text",
        "mcs150_date": "text",
        "mcs150_mileage": "text",
        "insurer_company_name": "text",
        "insurance_docket_number": "text",
        "insurance_policy_number": "text",
        "insurance_policy_type": "text",
        "insurance_form_code": "text",
        "insurance_max_coverage_amount": "text",
        "insurance_underlying_limit_amount": "text",
        "insurance_transaction_date": "text",
        "insurance_effective_date": "text",
        "insurance_expiration_date": "text",
        "phy_street": "text",
        "phy_city": "text",
        "phy_state": "text",
        "phy_zip": "text",
        "telephone": "text",
        "email_address": "text",
        "mailing_street": "text",
        "mailing_city": "text",
        "mailing_state": "text",
        "mailing_zip": "text",
        "mailing_country": "text",
        "carrier_operation": "text",
        "operation_classificiation": "text",
        "authority_date": "text",
        "authorized_for_common_date": "text",
        "authorized_for_contract_date": "text",
        "carrier_total_drivers": "text",
        "carrier_total_power_units": "text",
        "carried_cargo": "text",
        "carrier_driver_insp": "text",
        "carrier_driver_oos_insp": "text",
        "carrier_driver_oos_rate": 1,
        "carrier_driver_oos_rate_national_avg": 1,
        "carrier_vehicle_insp": "text",
        "carrier_vehicle_oos_insp": "text",
        "carrier_vehicle_oos_rate": 1,
        "carrier_vehicle_oos_rate_national_avg": 1,
        "carrier_hazmat_insp": "text",
        "carrier_hazmat_oos_insp": "text",
        "carrier_hazmat_oos_rate": 1,
        "carrier_hazmat_oos_rate_national_avg": 1,
        "carrier_fatal_crash": "text",
        "carrier_inj_crash": "text",
        "carrier_towaway_crash": "text",
        "carrier_crash_total": "text",
        "recordable_crash_rate": 1,
        "basic_unsafe_driving_total_violation": "text",
        "basic_driver_fitness_total_violation": "text",
        "basic_hos_total_violation": "text",
        "basic_drugs_alcohol_total_violation": "text",
        "BASIC_VEHICLE_MAINT_TOTAL_VIOLATION": "text",
        "carrier_safety_rating_date": "text",
        "carrier_safety_rating": "text",
        "carrier_safety_review_date": "text",
        "carrier_safety_review_type": "text"
      }
    ],
    "observations": [
      {
        "alpr_plate_number": "text",
        "usdot_number": "text",
        "time_captured": "text",
        "mc_number": "text",
        "vin": "text",
        "cab_number": "text",
        "equipment_type": "text",
        "equipment_number": "text",
        "equipment_logo": "text",
        "location_city": "text",
        "location_state": "text",
        "latitude": 1,
        "longitude": 1,
        "route": "text",
        "source": "text"
      }
    ]
  }
}

Successful Response