Skip to content

Booking

Book a transport

Book a transport

Request

Endpoint to book a transport

Security
bearerAuth
Bodyapplication/jsonrequired
itemsArray of objects(Item)
vehicle_typeinteger
Example:11
additional_informationstring
Example:"Attention: highly flammable goods"
loadingsArray of objects(SpotAddresses)
unloadingsArray of objects(SpotAddresses)
curl -i -X POST \
  https://docs.zipmend.com/_mock/openapi/booking/publish \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [
      {
        "name": "Product Name",
        "quantity": 22,
        "length": 120,
        "width": 100,
        "height": 80,
        "weight": 320
      }
    ],
    "vehicle_type": 13,
    "additional_information": "Attention: highly flammable goods",
    "loadings": [
      {
        "company_name": "Acme Corporation",
        "first_name": "John",
        "last_name": "Smith",
        "address_line_1": "Karl-Marx-Strasse 1",
        "address_line_2": "Tor 2",
        "country": "DE",
        "zip": "28779",
        "city": "Bremen",
        "phone": "+49123456789",
        "reference_number": "123456789",
        "dates": [
          {
            "start": "2024-07-20T07:00:00+01:00",
            "end": "2024-07-20T10:00:00+01:00"
          }
        ]
      }
    ],
    "unloadings": [
      {
        "company_name": "zipmend GmbH",
        "first_name": "Max",
        "last_name": "Mustermann",
        "address_line_1": "Steintorweg 4",
        "address_line_2": "Tor 2",
        "country": "DE",
        "zip": "12247",
        "city": "Berlin",
        "phone": "+49123456789",
        "reference_number": "123456789",
        "dates": [
          {
            "start": "2024-07-20T13:50:00+01:00",
            "end": "2024-07-20T16:50:00+01:00"
          }
        ]
      }
    ]
  }'

Responses

Created.

Bodyapplication/json
messagestringrequired
Example:"Booking created successfully."
dataobject(PublishBookingResponseData)required
Response
{ "message": "Success!", "data": { "id": "68ca7c622436dd852703e2b2", "order_number": 200949, "items": [ { "category": "other", "is_stackable": false, "quantity": 1, "name": "Tannenbaum", "weight": 320, "length": 120, "width": 100, "height": 80 } ], "additional_information": "Achtung leicht entzündliche Ware", "loadings": [ { "company_name": "Acme Corporation", "first_name": "John", "last_name": "Smith", "address_line_1": "Karl-Marx-Strasse 1", "address_line_2": "Tor 2", "country": "DE", "zip": "28779", "city": "Bremen", "phone": "+49123456789", "reference_number": "123456789", "dates": [ { "start": "2025-09-18T17:00:00+02:00", "end": "2025-09-18T19:00:00+02:00" } ] } ], "unloadings": [ { "company_name": "zipmend GmbH", "first_name": "Max", "last_name": "Mustermann", "address_line_1": "Steintorweg 4", "address_line_2": "Tor 2", "country": "DE", "zip": "12247", "city": "Berlin", "phone": "+49123456789", "reference_number": "123456789", "dates": [ { "start": "2025-09-18T19:50:00+02:00", "end": "2025-09-18T20:50:00+02:00" } ] } ] } }