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
Response
Returns the partnership data