Real time Capabilities

Real time Capabilities of the Carrier Recommendations Endpoint

With the new GenLogs Real-Time API, you can instantly identify carriers with the right equipment who are currently within a 150-mile radius of your origin and are likely seeking backhauls to your destination. This unique capability allows you to see which carriers are nearby right now, providing a significant advantage in the spot market. Integrate Real-Time GenLogs data into your TMS and internal systems to unlock new opportunities, increase efficiency, and reduce empty miles.

When the real_time parameter is set to 'True', the recommendation system prioritizes real-time data by applying additional weight to recent detections near the origin of the search. While the recommendations still incorporate historical data and follow the usual logic, the real-time information takes precedence, resulting in a more dynamic focus on current activity.

The is_real_time parameter is available exclusively to premium users. Reach out to us at [e-mail] now to unlock Real-Time freight data.

In addition to the base parameters described in Query Parameters:, can be also sent the parameter

1. real_time (boolean, optional): Determine if is needed to return recommendations including real time detections. Returns Real-Time usdot detections in recommendations, when the user has this functionality enabled.

Tip: If you receive a 403 error when using the real_time parameter, it means your user account doesn't have access to this premium feature. Please verify your access level and, if necessary, contact support at [e-mail] for assistance.

In addition to the base attributes described in Response: when the carrier recommendation request includes the real_time parameter , the response will also include the following attributes

1. recommendations (array of CarrierRecommendation objects): List of recommended carriers.

   1. is_real_time: bool, flag that indicates if result are based on real time detections

   2. is_inbound: bool

2. real_time_locs (dict of locations where detections are right now)

   1. dot_number: string, usdot of the detected carrier.

   2. current_lon: float, longitude of the detection location.

   3. current_lat: float, latitude of the detection location.

   4. is_inbound (bool): flag indicates when a carrier is currently inbound to the origin

Request Example

curl -X GET 'https://api.genlogs.io/carrier/recommendations?origin_city=Tucker&origin_state=Georgia&destination_city=Orange+Park&destination_state=Florida&origin_radius=50.0&destination_radius=50.0&fleet_size_min=0&fleet_size_max=1000&preferred_carriers=True&real_time=True' \
-H 'Access-Token: {access_token}' \
-H 'x-api-key: {your_api_key}' \
-i

Get the recommendations

GEThttps://api.genlogs.io/carrier/recommendations

Query parameters

Header parameters

Response

200

The JSON response containing recommendations and lane volume

Body

application/json

real_time_locs*array of CarrierRealTimeLocs (object)

recommendations*array of CarrierRecommendation (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.genlogs.io/carrier/recommendations?origin_city=0&origin_state=0&destination_city=0&destination_state=0&drive_time=0', {
    method: 'GET',
    headers: {
      "accept": "application/json",
      "Access-Token": "[Token]",
      "x-api-key": "[x-api-key]"
    },
});
const data = await response.json();

Response

200

{
  "real_time_locs": [
    {
      "current_lat": 0,
      "current_lon": 0,
      "dot_number": "text",
      "is_inbound": false
    }
  ],
  "recommendations": [
    {
      "add_date": "text",
      "bipd_insurance_on_file": 0,
      "cargo_insurance_on_file": 0,
      "carried_cargo": "text",
      "carrier_driver_oos_rate": 0,
      "carrier_driver_oos_rate_national_avg": 0,
      "carrier_score_scaled": 0,
      "carrier_total_power_units": 0,
      "carrier_vehicle_oos_rate": 0,
      "carrier_vehicle_oos_rate_national_avg": 0,
      "dba_name": "text",
      "dot_number": "text",
      "email_address": "text",
      "is_inbound": false,
      "is_real_time": false,
      "is_visually_sighted": false,
      "lat": 0,
      "legal_name": "text",
      "lon": 0,
      "mc_number": 0,
      "phy_city": "text",
      "phy_state": "text",
      "phy_street": "text",
      "phy_zip": "text",
      "telephone": "text"
    }
  ]
}