Here is an example for a quotation call for a national shipment, with the minimum request parameters:

curl --request POST \
     --url https://api.cargoboard.com/v1/quotations \
     --header 'Content-Type: application/json' \
     --header 'X-API-KEY: YOUR API KEY HERE' \
     --data '
{
     "product": "STANDARD",
     "shipper": {
          "address": {
               "postCode": "10115",
               "countryCode": "DE",
               "city": "Berlin"
          },
          "pickupOn": "2024-12-11"
     },
     "consignee": {
          "address": {
               "countryCode": "DE",
               "postCode": "33100",
               "city": "Paderborn"
          }
     },
     "lines": [
          {
               "unitQuantity": 1,
               "unitPackageType": "EP",
               "content": "furniture",
               "unitLength": 120,
               "unitWidth": 80,
               "unitHeight": 120,
               "unitWeight": 200
          }
     ]
}
'

Here is the response:

{
    "data": {
        "id": "cm33264tt04i0qt0dluradaf6",
        "costItems": [
            {
                "description": "Frachtkosten",
                "type": "SHIPMENT",
                "subtype": null,
                "price": {
                    "amount": 90.18,
                    "currency": "EUR"
                },
                "pricePartVat": {
                    "amount": 17.13,
                    "percentage": 19,
                    "currency": "EUR"
                }
            },
            {
                "description": "Klimaschutzbeitrag",
                "type": "CLIMATE_COMPENSATION_SURCHARGE",
                "subtype": null,
                "price": {
                    "amount": 0.67,
                    "currency": "EUR"
                },
                "pricePartVat": {
                    "amount": 0.13,
                    "percentage": 19,
                    "currency": "EUR"
                }
            }
        ],
        "pickupOn": "2024-12-11T07:00:00.000Z",
        "pickupAtFrom": "2024-12-11T07:00:00.000Z",
        "pickupAtUntil": "2024-12-11T15:00:00.000Z",
        "price": {
            "amount": 90.85,
            "currency": "EUR",
            "grossAmount": 108.11,
            "vatAmount": 17.26
        },
        "priceStandard": {
            "amount": 90.85,
            "currency": "EUR"
        },
        "runtime": {
            "daysMin": 1,
            "daysMax": 2
        },
        "delivery": {
            "earliest": "2024-12-12T07:00:00.000Z",
            "latest": "2024-12-13T15:00:00.000Z"
        },
        "product": "STANDARD",
        "transportType": "GROUPAGE",
        "co2Emission": {
            "amount": 0.67,
            "value": 33.88,
            "unit": "KG"
        }
    },
    "links": [
        {
            "description": "Get another quotation.",
            "href": "https://api.staging.cargoboard.com/v1/quotations",
            "method": "POST",
            "rel": "self"
        },
        {
            "rel": "quotationBook",
            "method": "POST",
            "description": "Book transport based on this quotation.",
            "href": "https://api.staging.cargoboard.com/v1/quotations/cm33264tt04i0qt0dluradaf6/book"
        }
    ]
}

What’s Next

What’s Next