Carrier Observation

Provide 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, and make informed underwriting decisions efficiently.

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:

• 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

GEThttps://api.genlogs.io/visual_sightings/carrier-observations

Query parameters

Header parameters

Response

200

Successful Response

Body

application/json

data*Data

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.genlogs.io/visual_sightings/carrier-observations?usdot_number=text', {
    method: 'GET',
    headers: {
      "accept": "application/json",
      "Access-Token": "[Token]",
      "x-api-key": "[x-api-key]"
    },
});
const data = await response.json();

Response

200

{
  "data": [
    {
      "alpr_plate_number": "p760855",
      "usdot_number": "3481976",
      "time_captured": "2024-06-05T20:28:06Z",
      "mc_number": "mc758629",
      "vin": "vincn556288",
      "cab_number": "56288",
      "equipment_type": "Reefer",
      "equipment_number": "123",
      "equipment_logo": "Pepsi",
      "location_city": "enfield",
      "location_state": "NC",
      "latitude": 4.56,
      "longitude": -84.36,
      "route": "95sb",
      "source": "genlogs"
    }
  ]
}