Skip to main content
POST
/
rates
/
history
Lookup rate history
curl --request POST \
  --url https://api.cargado.com/rates/history \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "requests": [
    {
      "stops": [
        {
          "type": "PICKUP",
          "placeDetails": {
            "place": {
              "address": "<string>",
              "type": "ADDRESS_STRING"
            },
            "coordinates": {
              "latitude": 0,
              "longitude": 0
            }
          }
        }
      ],
      "trailerRequirements": {
        "allowedTypes": [
          "DRY_VAN"
        ]
      },
      "routeMiles": 123
    }
  ]
}
'
{
  "results": [
    {
      "type": "DATA",
      "id": "<string>",
      "rateHistory": {
        "dayRange": {
          "start": "2023-12-25",
          "end": "2023-12-25"
        },
        "pricingLane": {
          "origin": {
            "type": "MARKET",
            "market": {
              "id": "<string>",
              "name": "<string>",
              "code": "<string>",
              "countryCode": "US",
              "centroid": {
                "latitude": 0,
                "longitude": 0
              }
            }
          },
          "destination": {
            "type": "MARKET",
            "market": {
              "id": "<string>",
              "name": "<string>",
              "code": "<string>",
              "countryCode": "US",
              "centroid": {
                "latitude": 0,
                "longitude": 0
              }
            }
          },
          "trailerCategory": "DRY_VAN",
          "usMxBorderCrossing": "LAREDO_INTL_BRIDGE"
        },
        "currencyCode": "USD",
        "latestSuggestedRate": {
          "dayRange": {
            "start": "2023-12-25",
            "end": "2023-12-25"
          },
          "amountDistribution": {
            "p25": 123,
            "p50": 123,
            "p75": 123
          },
          "marginOfError": 123,
          "relativeMarginOfError": 123,
          "confidenceScore": 123,
          "confidence": "STRONG"
        },
        "suggestedRates": [
          {
            "dayRange": {
              "start": "2023-12-25",
              "end": "2023-12-25"
            },
            "amountDistribution": {
              "p25": 123,
              "p50": 123,
              "p75": 123
            },
            "marginOfError": 123,
            "relativeMarginOfError": 123,
            "confidenceScore": 123,
            "confidence": "STRONG"
          }
        ],
        "perMileRates": [
          {
            "dayRange": {
              "start": "2023-12-25",
              "end": "2023-12-25"
            },
            "amountDistribution": {
              "p25": 123,
              "p50": 123,
              "p75": 123
            },
            "marginOfError": 123,
            "relativeMarginOfError": 123,
            "confidenceScore": 123,
            "confidence": "STRONG"
          }
        ],
        "latestAllInRate": {
          "dayRange": {
            "start": "2023-12-25",
            "end": "2023-12-25"
          },
          "amountDistribution": {
            "p25": 123,
            "p50": 123,
            "p75": 123
          },
          "marginOfError": 123,
          "relativeMarginOfError": 123,
          "confidenceScore": 123,
          "confidence": "STRONG"
        },
        "allInRates": [
          {
            "dayRange": {
              "start": "2023-12-25",
              "end": "2023-12-25"
            },
            "amountDistribution": {
              "p25": 123,
              "p50": 123,
              "p75": 123
            },
            "marginOfError": 123,
            "relativeMarginOfError": 123,
            "confidenceScore": 123,
            "confidence": "STRONG"
          }
        ],
        "routeMiles": 123,
        "routeMilesWithDeadhead": 123,
        "latestPerMileRate": {
          "dayRange": {
            "start": "2023-12-25",
            "end": "2023-12-25"
          },
          "amountDistribution": {
            "p25": 123,
            "p50": 123,
            "p75": 123
          },
          "marginOfError": 123,
          "relativeMarginOfError": 123,
          "confidenceScore": 123,
          "confidence": "STRONG"
        }
      },
      "alternateRateHistories": [
        {
          "dayRange": {
            "start": "2023-12-25",
            "end": "2023-12-25"
          },
          "pricingLane": {
            "origin": {
              "type": "MARKET",
              "market": {
                "id": "<string>",
                "name": "<string>",
                "code": "<string>",
                "countryCode": "US",
                "centroid": {
                  "latitude": 0,
                  "longitude": 0
                }
              }
            },
            "destination": {
              "type": "MARKET",
              "market": {
                "id": "<string>",
                "name": "<string>",
                "code": "<string>",
                "countryCode": "US",
                "centroid": {
                  "latitude": 0,
                  "longitude": 0
                }
              }
            },
            "trailerCategory": "DRY_VAN",
            "usMxBorderCrossing": "LAREDO_INTL_BRIDGE"
          },
          "currencyCode": "USD",
          "latestSuggestedRate": {
            "dayRange": {
              "start": "2023-12-25",
              "end": "2023-12-25"
            },
            "amountDistribution": {
              "p25": 123,
              "p50": 123,
              "p75": 123
            },
            "marginOfError": 123,
            "relativeMarginOfError": 123,
            "confidenceScore": 123,
            "confidence": "STRONG"
          },
          "suggestedRates": [
            {
              "dayRange": {
                "start": "2023-12-25",
                "end": "2023-12-25"
              },
              "amountDistribution": {
                "p25": 123,
                "p50": 123,
                "p75": 123
              },
              "marginOfError": 123,
              "relativeMarginOfError": 123,
              "confidenceScore": 123,
              "confidence": "STRONG"
            }
          ],
          "perMileRates": [
            {
              "dayRange": {
                "start": "2023-12-25",
                "end": "2023-12-25"
              },
              "amountDistribution": {
                "p25": 123,
                "p50": 123,
                "p75": 123
              },
              "marginOfError": 123,
              "relativeMarginOfError": 123,
              "confidenceScore": 123,
              "confidence": "STRONG"
            }
          ],
          "latestAllInRate": {
            "dayRange": {
              "start": "2023-12-25",
              "end": "2023-12-25"
            },
            "amountDistribution": {
              "p25": 123,
              "p50": 123,
              "p75": 123
            },
            "marginOfError": 123,
            "relativeMarginOfError": 123,
            "confidenceScore": 123,
            "confidence": "STRONG"
          },
          "allInRates": [
            {
              "dayRange": {
                "start": "2023-12-25",
                "end": "2023-12-25"
              },
              "amountDistribution": {
                "p25": 123,
                "p50": 123,
                "p75": 123
              },
              "marginOfError": 123,
              "relativeMarginOfError": 123,
              "confidenceScore": 123,
              "confidence": "STRONG"
            }
          ],
          "routeMiles": 123,
          "routeMilesWithDeadhead": 123,
          "latestPerMileRate": {
            "dayRange": {
              "start": "2023-12-25",
              "end": "2023-12-25"
            },
            "amountDistribution": {
              "p25": 123,
              "p50": 123,
              "p75": 123
            },
            "marginOfError": 123,
            "relativeMarginOfError": 123,
            "confidenceScore": 123,
            "confidence": "STRONG"
          }
        }
      ]
    }
  ]
}

Authorizations

​
api-key
string
header
required

Body

application/json

See the Rate Lookup guide for more information.

​
requests
object[]
required

A list of load descriptions to get rate history for.

Required array length: 1 - 16 elements

Response

Ok

​
results
object[]
required

The result for each input request; the request and result arrays are the same size and their elements map 1:1. Each result is either a successful lookup or an error; each request succeeds or fails independently.

See the Rate Lookup guide for more information.