Carrier Profile

Carrier Profile Endpoint

Retrieve FMCSA details, Equipment Pairings, and USDOT Sightings for one or more carriers, with optional date filters for sightings.

Authentication

Include your Access-Token in the header of your requests.
Include your x-api-key The API key provided by GenLogs. This header must be included in the request.

Permissions

The external-api-carrier-profile permission is required to access this endpoint.

Endpoint

URL: https://api.genlogs.io/carrier/profile
Method: GET

Headers

Access-Token: (string, required): Access token obtained from the "Create Access Token" endpoint.
x-api-key (string, required): The API key provided by GenLogs.

Query Parameters:

usdot_numbers (string, required): One or more USDOT numbers, separated by commas.
start_date (string, optional): Start date for filtering USDOT sightings (up to 3 years ago).
end_date (string, optional): End date for filtering USDOT sightings (cannot exceed the current date).

Understanding carrier profile information

Responses are always grouped by USDOT, and within each USDOT you may find:

FMCSA Detail – always present.
Equipment Pairings – may be empty depending on the available information.
USDOT Sightings – may be empty depending on the filters applied.

This means that while FMCSA Detail is guaranteed for every USDOT, the Pairing Data and Sightings sections may not return results if they do not match the requested filters.

Carrier Profile returns three arrays per USDOT.

FMCSA Detail: FMCSA details with equipment pairings and USDOT sightings for specified carriers
- 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).
Equipment Pairings: equipment pairings for specified carriers, as observed by GenLogs:
- name: equipment type name
- value_percent: percentage score
USDOT Sightings: Retrieves USDOT sightings for specified carriers within a date range.
- sighting_date: Date when the sighting occurred.
- state_seen: U.S. state where the sighting was recorded.
- location_zip: 3-digit ZIP code prefix representing the location of the sighting.

Response:

200 OK: A JSON object containing 3 sets of carrier details.
400 Bad Request: If required parameters are missing or invalid.
401 Unauthorized: If the authentication credentials (Access-Token) is missing or incorrect.
403 Forbidden: If the permission has not been added to your user.
500 Internal Server Error: If there is an issue on the server that prevents processing the request.

Response Body:

Data (object of CarrierProfile objects): Set of carrier profiles grouped by usdot_number.

Request Example:

curl --location 'https://api.genlogs.io/carrier/profile?usdot_number=2350084%2C10553&start_date=2025-09-01&end_date=2025-09-12' \
--header 'Access-Token: {your_api_token}'

Get carrier profile details

get

Retrieve a comprehensive carrier profile details including FMCSA details, equipment pairings, and sightings data for specified USDOT numbers.

Query parameters

usdot_numberstring[]Required

USDOT numbers to filter data for specific carriers

start_datestring · dateOptional

Start date for sightings in YYYY-MM-DD format

end_datestring · dateOptional

End date for sightings in YYYY-MM-DD format

Header parameters

Access-TokenstringRequired

Bearer token for authentication

Responses

200

Successful response

application/json

400

Bad Request - invalid parameters

application/json

401

Unauthorized – missing token

application/json

403

Forbidden – invalid token or insufficient permissions

application/json

500

Internal Server Error

application/json

get

carrier/profile

GET carrier/profile?usdot_number=text HTTP/1.1
Host: 
Access-Token: text
Accept: */*

{
  "10553": {
    "fmcsa_detail": {
      "usdot_number": "10553",
      "legal_name": "GN LOGISTICS LLC",
      "dba_name": "N/A",
      "entity_type": "Corporation",
      "carrier_operation": "Interstate",
      "cargo_carried": "General Freight",
      "hazmat_authorized": "No",
      "carrier_status": "Active",
      "out_of_service_date": "N/A",
      "legal_address": "123 Main St",
      "physical_address": "123 Main St",
      "mailing_address": "123 Main St",
      "telephone": "555-123-4567",
      "fax": "N/A",
      "email": "[email protected]",
      "mcs_150_form_date": "2020-01-15",
      "mcs_150_mileage_year": "2023",
      "dot_number": "10553",
      "docket_number": "MC-123456",
      "mc_mx_ff_number": "MC-123456",
      "power_units": "5",
      "drivers": "3",
      "mcs_150_mileage": "50000"
    },
    "equipment_pairings": {
      "genlogs": [
        {
          "name": "Dry Van",
          "value_percent": "100.0"
        }
      ],
      "fmcsa": [
        {
          "name": "Dry Van",
          "value_percent": "88.9"
        },
        {
          "name": "Flatbed",
          "value_percent": "2.8"
        },
        {
          "name": "Reefer",
          "value_percent": "8.3"
        }
      ]
    },
    "sightings": [
      {
        "sighting_date": "2024-01-15",
        "state_seen": "CA",
        "location_zip": "902"
      },
      {
        "sighting_date": "2024-01-20",
        "state_seen": "TX",
        "location_zip": "752"
      }
    ]
  }
}

PreviousCarrier Contacts NextShipper Lanes

Last updated 1 month ago