--- title: "Get Freight Market Data for Lane" method: POST path: "/partnership/data" tags: ["Partnership"] --- # Get Freight Market Data for Lane `POST /partnership/data` 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 ## Headers - `x-api-version` string ## Request body - PartnershipDataRequest — Request model for the Partnership Integration API endpoint - `origin` string, required — Origin location - can be ZIP code, ZIP3, or KMA - `destination` string, required — Destination location - can be ZIP code, ZIP3, or KMA - `equipmentType` string, required — Equipment type - must be VAN, REEFER, or FLATBED - `miles` number, double — Optional length of haul in miles. If not provided, will be calculated ## Response `200` Returns the partnership data - PartnershipDataResponse — Response model for the Partnership Integration API endpoint - `origin` string — Origin location - can be ZIP5 or ZIP3 - `destination` string — Destination location - can be ZIP5 or ZIP3 - `miles` number, double — Length of haul in miles (provided or calculated) - `trac_rate` number, double — TRAC spot rate per mile - `trac_rate_high` number, double — TRAC rate high value - `trac_rate_low` number, double — TRAC rate low value - `trac_rpm` number, double — TRAC rate per mile (RPM) - `trac_rpm_high` number, double — TRAC rate per mile high value - `trac_rpm_low` number, double — TRAC rate per mile low value - `nti_usa_value` number, double — National Truckload Index USA value - `otri_origin_market` number, double — Outbound Tender Rejection Index for origin market - `otvi_origin_market` number, double — Outbound Tender Volume Index for origin market - `csteu_usa_value` number, double — Contract Save to Expectations USA value - `orail_usa_value` number, double — Outbound Rail Percentage USA value - `haul_value` number, double — Average length of haul value (equipment-specific when available) - `sonar_lane_score` integer — SONAR Lane Score for the origin/destination pair - `equipment_type` 'VAN' | 'REEFER' | 'FLATBED' ## Other responses - `400` — Invalid request parameters - `401` — Unauthorized - invalid or missing authentication - `403` — Forbidden - organization not entitled to Partnership API - `429` — Too Many Requests - rate limit exceeded - `500` — Internal server error --- [API](https://skmtc.net/freightwaves/apis/sonar-api.md) · [All operations](https://skmtc.net/freightwaves/apis/sonar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freightwaves/sonar-api/revisions/3a995f316cda/schema)