Sign in
latestSwagger 2.02026-08-1274120326.8 KB

3a995f316cda

Truckload V2

Bulk Truckload Rates (beta)

This endpoint allows permissioned users to get our SONAR bulk truckload rates, based on an origin state/provinces and route mileage. Our rate data is being updated weekly and is available for most US states and Canadian provinces. Miles are required and must be greater than 0.

You can click on the Body Sample to the right to populate the example in the test body below.

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

This endpoint handles the following input fields:

  • start_date: the earliest date of the range over which the rate is being requested (YYYY-MM-DD), required
  • end_date: the most recent date of the range over which the rate is being requested (YYYY-MM-DD), required
  • lane_id: a unique identifier set by the client and will be returned with the response; optional field, not required
  • origin_state_code: the 2 character US State or Canadian Province Code for the origin, required
  • loaded_miles: the one way mileage of the load, required, must be greater than 0
  • rate_type: the type of rate being requested, may be 'ROUNDTRIP' or 'ONEWAY', optional field, defaults to 'ROUNDTRIP'

Here are the output fields returned in a successful call:

  • Lanes: A list object that contains the output information associated with the valid requested lanes
    • lane_id: the unique identifier sent in the corresponding call
    • loaded_miles: the one way mileage for the load, as entered in the request
    • rate_type: the type of rate, either round trip or one way as entered in the request
    • origin_state_code: the 2 character US State Code for the origin, as provided in the request
    • data_date: the date for which the data in the response was calculated (ie: the date to which the rates in the response were applicable)
    • rate_high: the upper confidence interval of the median total rate, corresponding to the origin state, loaded miles and rate type provided in the API call by the client
    • rate_low: the lower confidence interval of the median total rate, corresponding to the origin state, loaded miles and rate type provided in the API call by the client
    • rate_median: the median total rate, corresponding to the origin state, loaded miles and rate type provided in the API call by the client
  • Errors: a list object that contains information on lanes that are not valid for the rate request
    • lane_id: the unique identifier sent in the corresponding call
    • origin_state_code: the state code string provided in the request
    • loaded_miles: the miles provided by the client in the request
    • rate_type: the type of rate provided by the client in the request, or defaulted to 'ROUNDTRIP'
    • error_found: A lane specific explanation of the issue with the lane information that caused an error
post/v2/truckload/rates/bulk

Headers

x-api-versionstring

Request body

start_datestring date
end_datestring date

Example request

{
  "start_date": "2026-03-01",
  "end_date": "2026-03-15",
  "lanes": [
    {
      "lane_id": "AL-520",
      "origin_state_code": "AL",
      "loaded_miles": 520,
      "rate_type": "ROUNDTRIP"
    }
  ]
}

Response

OK

Example response

{
  "lanes": [
    {
      "lane_id": "TN-650",
      "origin_state_code": "TN",
      "loaded_miles": 500,
      "rate_type": "ROUNDTRIP",
      "data_date": "2026-01-01",
      "rate_low": 2407.19,
      "rate_median": 2638.59,
      "rate_high": 2869.98
    }
  ],
  "errors": [
    {
      "lane": {
        "lane_id": "AL-520",
        "origin_state_code": "AL",
        "loaded_miles": 520,
        "rate_type": "ROUNDTRIP"
      }
    }
  ]
}