Required shipper and consignee fields for quotations and bookings, and what the optional fields do.
Every quotation and order needs information about the shipper (where the goods are picked up) and the consignee (where they are delivered). The request body is identical for both endpoints — a booking simply requires more address fields than a quotation.
Minimum for a quotation
{
"shipper": {
"address": {
"countryCode": "DE",
"postCode": "10115",
"city": "Berlin"
},
"pickupOn": "2026-12-01"
},
"consignee": {
"address": {
"countryCode": "DE",
"postCode": "10115",
"city": "Berlin"
}
}
}Minimum for a booking
A booking additionally requires the name and address.street of both shipper and consignee, and a pickup date — either pickupOn or a pickup window with pickupAtFrom and pickupAtUntil (at least 2 hours). Pickup dates must be today or later, Monday to Friday. For pickups in Romania (RO), shipper.contactPerson is also required.
{
"shipper": {
"name": "Producer ABC GmbH & Co. KG",
"address": {
"street": "Examplestreet 12a",
"countryCode": "DE",
"postCode": "10115",
"city": "Berlin"
},
"pickupOn": "2026-12-01"
},
"consignee": {
"name": "Consignee ABC AG",
"address": {
"street": "Examplestreet 5",
"countryCode": "DE",
"postCode": "10115",
"city": "Berlin"
}
}
}
Use upcoming datesThe dates on this page are examples only. Use an upcoming pickup date in your requests.
All fields
Besides the mandatory fields, you can send further details and book additional services. The more information you provide, the smoother we can process your shipment.
{
"shipper": {
"name": "Producer ABC GmbH & Co. KG",
"address": {
"street": "Examplestreet 12a",
"countryCode": "DE",
"postCode": "10115",
"city": "Berlin"
},
"contactPerson": {
"name": "Jane Doe",
"phone": "+49 30 12345678",
"email": "[email protected]"
},
"neutralData": {
"name": "Selling Company ABC GmbH",
"street": "Examplestreet 1",
"postCode": "10115",
"countryCode": "DE",
"city": "Berlin"
},
"pickupAtFrom": "2026-12-01T08:00:00.000Z",
"pickupAtUntil": "2026-12-01T14:00:00.000Z",
"wantsTailLiftTruck": true,
"wantsContactBeforePickup": false,
"freeTextForPickup": "Gate 3, open Mon–Fri 07:00–15:00",
"reference": "ABC123"
},
"consignee": {
"name": "Consignee ABC AG",
"address": {
"street": "Examplestreet 5",
"countryCode": "DE",
"postCode": "10115",
"city": "Berlin"
},
"contactPerson": {
"name": "John Doe",
"phone": "+49 30 87654321",
"email": "[email protected]"
},
"neutralData": {
"name": "Selling Company ABC GmbH",
"street": "Examplestreet 1",
"postCode": "10115",
"countryCode": "DE",
"city": "Berlin"
},
"deliveryOn": "2026-12-03",
"isPrivateCustomer": false,
"wantsTailLiftTruck": true,
"wantsContactBeforeDelivery": false,
"wantsPhoneCallFromDriverBeforeDelivery": false,
"wantsDeliveryWithoutConsigneePresence": true,
"freeTextForDelivery": "Lunch break 12:00–13:00",
"reference": "ABC123"
}
}Field reference
| Field | Used in | Description |
|---|---|---|
name | shipper, consignee | Company or person name. Required for bookings. |
address.street, address.postCode, address.city, address.countryCode | shipper, consignee | Pickup or delivery address. countryCode is a two-letter ISO code such as DE. street is required for bookings. |
contactPerson.name, .phone, .email | shipper, consignee | Local contact person for pickup or delivery. |
neutralData | shipper, consignee | Neutral address shown to the other party — see Neutral address. |
pickupOn | shipper | Pickup day (YYYY-MM-DD). Use either pickupOn or pickupAtFrom + pickupAtUntil. |
pickupAtFrom, pickupAtUntil | shipper | Pickup time window (ISO 8601 date-time), at least 2 hours. |
deliveryOn | consignee | Fixed delivery day (YYYY-MM-DD). Required for FIX products (FIX, FIX_8 … FIX_16) and not allowed for other products — see Shipment Products. |
isPrivateCustomer | consignee | Set to true if the consignee is a private person (B2C). A surcharge applies — see Private consignees. |
wantsTailLiftTruck | shipper, consignee | Additional service: truck with tail lift. |
wantsContactBeforePickup | shipper | Additional service: contact the shipper before pickup. |
wantsContactBeforeDelivery | consignee | Additional service: contact the consignee before delivery. |
wantsPhoneCallFromDriverBeforeDelivery | consignee | Additional service: the driver calls before delivery. |
wantsDeliveryWithoutConsigneePresence | consignee | Additional service: delivery without the consignee being present. |
freeTextForPickup, freeTextForDelivery | shipper, consignee | Notes for pickup or delivery, such as opening hours or break times. |
reference | shipper, consignee | Reference the driver uses when notifying the shipper or consignee. |
All wants… fields are additional services. They can affect the price and appear as separate cost items in the response.
Private consignees (B2C)
For deliveries to private persons, set consignee.isPrivateCustomer: true (a surcharge applies) and book one of these delivery options, so the delivery can be completed on the first attempt:
| Option | Field | Effect |
|---|---|---|
| Delivery notification | consignee.wantsContactBeforeDelivery: true | The consignee is contacted beforehand to arrange the delivery |
| Release to deposit | consignee.wantsDeliveryWithoutConsigneePresence: true | The goods may be delivered without the consignee being present |
Make sure consignee.contactPerson contains a phone number or e-mail address so the consignee can be reached. A complete example is shown in B2C shipment with dangerous goods.
Neutral address (neutralData)
neutralData)A neutral address hides the actual pickup or delivery location from the other party. The truck never drives to the neutral address.
Example: The goods are picked up directly at your manufacturer, but your customer should see your company as the shipper. Put the manufacturer in shipper.name and shipper.address (where the truck actually goes) and your own company in shipper.neutralData.
Neutral addresses are not available for parcel shipments.