cargopanel logocargopanel for developers

Shipping Rates

POSThttps://api.cargopanel.co/api/v1/shipping/rates

Calculate shipping rates for your parcels.

This API requires a contract. Get in touch with cargopanel Support Team.

Path Params

countryFromstringrequired

Origin country ISO code

countryTostringrequired

Destination country ISO code

postalCodestringoptional

Postal code for remote area surcharge calculation

heightnumberrequired

Package height in centimeters

widthnumberrequired

Package width in centimeters

lengthCmnumberrequired

Package length in centimeters

piecenumberrequired

Number of pieces in the package

pieceWeightnumberrequired

Weight of each piece in kilograms

Request Body

The request body should be a JSON object containing the following structure under a data key:

{
  "data": {
    "packages": [
      {
        "height": <number>,
        "width": <number>,
        "lengthCm": <number>,
        "piece": <number>,
        "pieceWeight": <number>
      }
    ],
    "countryFrom": "<ISO_CODE>",
    "countryTo": "<ISO_CODE>",
    "postalCode": "<string>" // Optional for remote area surcharge
  }
}

Example Response

{
    "success": true,
    "proposals": [
        {
            "companyId": "tk3434",
            "companyName": "Widect",
            "serviceType": "Economy",
            "deliveryTime": "3-8",
            "price": "9.26",
            "currency": "EUR",
            "data": {
                "packages": [
                    {
                        "height": 10,
                        "width": 10,
                        "lengthCm": 10,
                        "piece": 1,
                        "pieceWeight": 0.5
                    }
                ],
                "countryFrom": "TR",
                "countryTo": "GB",
                "postalCode": "10469"
            }
        }
    ]
}

Responses

200Rates calculated successfully
400Bad Request - Missing required data or invalid input
404No shipping carriers found
500Internal Server Error