latestSwagger 2.02026-08-1274120326.8 KB

3a995f316cda

Partnership

Get Freight Market Data for Lane

This endpoint allows permissioned users to retrieve comprehensive freight market data for a specific trucking lane, providing real-time market rates and indices in a single API call.

For more information about getting access to this endpoint or using this endpoint, please reach out to our Customer Success team (cs@gosonar.com).

Returns current market data including TRAC rates, freight market indices, and lane scoring metrics for the specified origin-destination pair and equipment type.

This endpoint handles the following input fields:

  • origin: ZIP3 or ZIP5 code for the shipment origin (e.g., "123" or "12345"), required
  • destination: ZIP3 or ZIP5 code for the shipment destination (e.g., "456" or "45678"), required
  • equipment_type: Type of trucking equipment - must be one of: "VAN", "REEFER", or "FLATBED", required
  • miles: Specific lane distance in miles for rate calculations. If not provided, the system will calculate the miles automatically based on origin and destination. Must be a positive number if provided, optional

Here are the output fields returned in a successful call:

  • origin: The Zip3/Zip5 code for the lane origin, as provided in the request
  • destination: The Zip3/Zip5 code for the lane destination, as provided in the request
  • miles: The lane distance in miles
  • trac_rate: The median total (linehaul plus fuel surcharge) rate that corresponds to the origin, destination, equipment_type and data_timestamp provided in the API call by the client
  • trac_rate_high: The high-end (67th percentile) total (linehaul plus fuel surcharge) rate that corresponds to the origin, destination, equipment_type and data_timestamp provided in the API call by the client
  • trac_rate_low: The low-end (33rd percentile) total (linehaul plus fuel surcharge) rate that corresponds to the origin, destination, equipment_type and data_timestamp provided in the API call by the client
  • trac_rpm: The median total (linehaul plus fuel surcharge) rate-per-mile that corresponds to the origin, destination, equipment_type and data_timestamp provided in the API call by the client
  • trac_rpm_high: The high-end (67th percentile) total (linehaul plus fuel surcharge) rate-per-mile that corresponds to the origin, destination, equipment_type and data_timestamp provided in the API call by the client
  • trac_rpm_low: The low-end (33rd percentile) total (linehaul plus fuel surcharge) rate-per-mile that corresponds to the origin, destination, equipment_type and data_timestamp provided in the API call by the client
  • nti_usa_value: The National Truckload Index value for the USA
  • otri_origin_market: The Outbound Tender Rejection Index value for the origin market
  • otvi_origin_market: The Outbound Tender Volume Index value for the origin market
  • csteu_usa_value: The US Customs Maritime Import TEUs value for the USA
  • orail_usa_value: The Total Outbound Rail Container Volume value for the USA
  • haul_value: Shows the difference between the Outbound Tender Volume Index (OTVI) and the Inbound Tender Volume Index (ITVI). Negative is inbound heavy Positive is outbound heavy.
  • sonar_lane_score: The lane score for the requested lane
  • equipment_type: The type of trucking equipment used in the request returned
post/partnership/data

Headers

x-api-versionstring

Request body

originstring required

Origin location - can be ZIP code, ZIP3, or KMA

destinationstring required

Destination location - can be ZIP code, ZIP3, or KMA

equipmentTypestring required

Equipment type - must be VAN, REEFER, or FLATBED

milesnumber double

Optional length of haul in miles. If not provided, will be calculated

Response

Returns the partnership data

originstring

Origin location - can be ZIP5 or ZIP3

destinationstring

Destination location - can be ZIP5 or ZIP3

milesnumber double

Length of haul in miles (provided or calculated)

trac_ratenumber double

TRAC spot rate per mile

trac_rate_highnumber double

TRAC rate high value

trac_rate_lownumber double

TRAC rate low value

trac_rpmnumber double

TRAC rate per mile (RPM)

trac_rpm_highnumber double

TRAC rate per mile high value

trac_rpm_lownumber double

TRAC rate per mile low value

nti_usa_valuenumber double

National Truckload Index USA value

otri_origin_marketnumber double

Outbound Tender Rejection Index for origin market

otvi_origin_marketnumber double

Outbound Tender Volume Index for origin market

csteu_usa_valuenumber double

Contract Save to Expectations USA value

orail_usa_valuenumber double

Outbound Rail Percentage USA value

haul_valuenumber double

Average length of haul value (equipment-specific when available)

sonar_lane_scoreinteger

SONAR Lane Score for the origin/destination pair

equipment_type'VAN' | 'REEFER' | 'FLATBED'