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 carrier recommendations based on location

get

/carrier/recommendations

Query parameters

origin_citystring · default: Nashvillerequired

Origin city for the recommendation

Example: Tennessee City

origin_statestring · default: TNrequired

Origin state for the recommendation

Example: Tennessee

destination_citystring · default: Dallasrequired

Destination city for the recommendation

Example: Tascosa

destination_statestring · default: TXrequired

Destination state for the recommendation

Example: Texas

origin_radiusnumber · default: 50

Search radius around the origin location in miles

Example: 50

destination_radiusnumber · default: 50

Search radius around the destination location in miles

Example: 50

carrier_score_minnumber · default: 0

Minimum carrier score

Example: 0

carrier_score_maxnumber · default: 100

Maximum carrier score

Example: 100

fleet_size_minnumber · default: 1

Minimum fleet size

Example: 1

fleet_size_maxnumber · default: 500

Maximum fleet size

Example: 500

carried_cargostring · default: general goods

Type of cargo carried

Example: general goods

equipment_typesstring · default: flatbed

Type of equipment used by carriers

Example: flatbed

preferred_carriersboolean · default: false

Filter for preferred carriers

Example: true

real_timeboolean · default: false

Request real-time data if available

Example: true

auth_months_minnumber · default: 1

Minimum number of months a carrier has an active common or contract authority with FMCSA

Example: 1

Header parameters

acceptstring · default: application/jsonrequired

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/carrier/recommendations?origin_city=Tennessee+City&origin_state=Tennessee&destination_city=Tascosa&destination_state=Texas' \
  --header 'accept: application/json' \
  --header 'Access-Token: [Token]' \
  --header 'x-api-key: [x-api-key]'

200

200

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

The JSON response containing recommendations and lane volume