API Documentation

Postman collection → OpenAPI spec →

Introduction

This documentation aims to provide all the information you need to work with our API.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

Company Authentication

Palletspace Orders

APIs for managing orders

APIs for managing stock orders


Display a listing of all company orders

GET
https://warespace.de
/api/palletspace/v1/company/orders
requires authentication

This endpoint gives you a listing of palletspace orders for a company.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

status
string

Status to filter by. Possible options are requested, cancelled, inbound, stock, outsourced, quality_issue, fulfilled

Example:
stock
page
integer

Current page number. Defaults to '1'.

Example:
5
page_size
integer

Size of a page. Defaults to '100'.

Example:
20
Example request: 
curl --request GET \
    --get "https://warespace.de/api/palletspace/v1/company/orders?status=stock&page=5&page_size=20" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "id": 1,
            "orderNumber": "6b885e57-c75a-3452-a067-9c2825fbab8b",
            "createdAt": "2021-09-17",
            "createdBy": "John Doe",
            "orders": [
                {
                    "id": 24,
                    "name": "Location Name A",
                    "pallets": [
                        {
                            "id": 13,
                            "palletspace_pallet_id": 1,
                            "order_number": "5-24413802409-1",
                            "inbound_date": null,
                            "outbound_date": null,
                            "status": {
                                "label": "Requested",
                                "value": "requested"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 14,
                            "palletspace_pallet_id": 2,
                            "order_number": "5-24413802409-2",
                            "inbound_date": "2023-04-01",
                            "outbound_date": "2023-07-07",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 15,
                            "palletspace_pallet_id": 3,
                            "order_number": "5-24413802409-3",
                            "inbound_date": "2023-10-01",
                            "outbound_date": "2023-11-20",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        }
                    ],
                    "inboundDate": "2021-10-01",
                    "outboundDate": "2021-10-02",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    }
                },
                {
                    "id": 45,
                    "name": "Location Name B",
                    "pallets": [
                        {
                            "id": 10,
                            "palletspace_pallet_id": 1,
                            "order_number": "4-24413802409-1",
                            "inbound_date": null,
                            "outbound_date": null,
                            "status": {
                                "label": "Requested",
                                "value": "requested"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 11,
                            "palletspace_pallet_id": 2,
                            "order_number": "4-24413802409-2",
                            "inbound_date": "2023-04-01",
                            "outbound_date": "2023-07-07",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 12,
                            "palletspace_pallet_id": 3,
                            "order_number": "4-24413802409-3",
                            "inbound_date": "2023-10-01",
                            "outbound_date": "2023-11-20",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        }
                    ],
                    "inboundDate": "2023-01-31",
                    "outboundDate": "2023-07-08",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    }
                },
                {
                    "id": 657,
                    "name": "Location Name C",
                    "pallets": [
                        {
                            "id": 7,
                            "palletspace_pallet_id": 1,
                            "order_number": "3-24413802409-1",
                            "inbound_date": null,
                            "outbound_date": null,
                            "status": {
                                "label": "Requested",
                                "value": "requested"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 8,
                            "palletspace_pallet_id": 2,
                            "order_number": "3-24413802409-2",
                            "inbound_date": "2023-04-01",
                            "outbound_date": "2023-07-07",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 9,
                            "palletspace_pallet_id": 3,
                            "order_number": "3-24413802409-3",
                            "inbound_date": "2023-10-01",
                            "outbound_date": "2023-11-20",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        }
                    ],
                    "inboundDate": "2023-10-01",
                    "outboundDate": "2023-11-20",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    }
                }
            ]
        },
        {
            "id": 2,
            "orderNumber": "9134bab7-da5d-35ec-89ed-6dfe114c9f09",
            "createdAt": "2023-08-29",
            "createdBy": "Jane Doe",
            "orders": [
                {
                    "id": 767,
                    "name": "Location Name A",
                    "pallets": 12344,
                    "inboundDate": "2021-10-01",
                    "outboundDate": "2021-10-02",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    }
                }
            ]
        },
        {
            "id": 3,
            "orderNumber": "f244716a-7212-3ab7-86f4-01f25f2af21b",
            "createdAt": "2021-09-12",
            "createdBy": "John Doe",
            "orders": [
                {
                    "id": 8,
                    "name": "Location Name A",
                    "pallets": 12344,
                    "inboundDate": "2020-09-31",
                    "outboundDate": "2021-10-09",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    }
                },
                {
                    "id": 96,
                    "name": "Location Name B",
                    "pallets": [
                        {
                            "id": 1,
                            "palletspace_pallet_id": 1,
                            "order_number": "1-24413802409-1",
                            "inbound_date": null,
                            "outbound_date": null,
                            "status": {
                                "label": "Requested",
                                "value": "requested"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 2,
                            "palletspace_pallet_id": 2,
                            "order_number": "1-24413802409-2",
                            "inbound_date": "2023-04-01",
                            "outbound_date": "2023-07-07",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 3,
                            "palletspace_pallet_id": 3,
                            "order_number": "1-24413802409-3",
                            "inbound_date": "2023-10-01",
                            "outbound_date": "2023-11-20",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        }
                    ],
                    "inboundDate": "2023-04-01",
                    "outboundDate": "2023-07-07",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    }
                },
                {
                    "id": 2,
                    "name": "Location Name C",
                    "pallets": [
                        {
                            "id": 4,
                            "palletspace_pallet_id": 1,
                            "order_number": "2-24413802409-1",
                            "inbound_date": null,
                            "outbound_date": null,
                            "status": {
                                "label": "Requested",
                                "value": "requested"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 5,
                            "palletspace_pallet_id": 2,
                            "order_number": "2-24413802409-2",
                            "inbound_date": "2023-04-01",
                            "outbound_date": "2023-07-07",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        },
                        {
                            "id": 6,
                            "palletspace_pallet_id": 3,
                            "order_number": "2-24413802409-3",
                            "inbound_date": "2023-10-01",
                            "outbound_date": "2023-11-20",
                            "status": {
                                "label": "Stock",
                                "value": "stock"
                            },
                            "createdAt": "2021-09-17 12:00:00"
                        }
                    ],
                    "inboundDate": "2023-10-01",
                    "outboundDate": "2023-11-20",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    }
                }
            ]
        }
    ]
}
{
    "message": "Unauthenticated."
}

ECL Orders

APIs for managing orders for the easy connected logistics platform.

APIs for managing orders for the easy connected logistics platform.


Display a listing of all ecl orders

GET
https://warespace.de
/api/warespace/v1/company/ecl/orders
requires authentication

This endpoint gives you a listing of palletspace orders for a company.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

page
integer

Current page number. Defaults to '1'.

Example:
5
page_size
integer

Size of a page. Defaults to '20'.

Example:
20
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/company/ecl/orders?page=5&page_size=20" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "id": 1,
            "status": "pending",
            "ordered_at": "2024-12-07 10:19:00",
            "sscc": "123456789012345678",
            "customer": {
                "user": {
                    "id": 25,
                    "name": "John Doe",
                    "email": "nyrowe@mailinator.com",
                    "phone_number_business": "+49 123 456789",
                    "job_title": "Vertrieb",
                    "locale": "de"
                },
                "company": {
                    "id": 5,
                    "name": "Mustermann GmbH",
                    "address_line_1": "Tulpenweg 18a",
                    "address_line_2": "Tor 2",
                    "postal_code": "12345",
                    "city": "München",
                    "country": "DE",
                    "phone": "+1 (467) 613-7239",
                    "email": "company@example.com",
                    "billing_email": "billing@company.com",
                    "website": "www.company.com"
                }
            },
            "warehouse": {
                "id": 5,
                "name": "Falcon 3",
                "address_line_1": "Beispielstr. 5",
                "address_line_2": "",
                "postal_code": "12345",
                "city": "Wiesbaden",
                "country": "DE",
                "phone": "0123456789",
                "sales_mail": [
                    "sales@example.de"
                ],
                "contact_mail": [
                    "contact@example.de"
                ]
            },
            "order_material": [
                {
                    "id": 1,
                    "quantity": 500,
                    "unit_of_measure": "kg",
                    "material": {
                        "material_number": "A12345678901234567",
                        "material_type": "roh",
                        "base_unit_of_measure": "m",
                        "gross_weight": 1000,
                        "net_weight": 980,
                        "weight_unit": "g",
                        "volume": 1,
                        "volume_unit": "m3",
                        "temperature_conditions_indicator": "c",
                        "international_article_number": "9783161484100",
                        "length": 2.5,
                        "width": 1.2,
                        "height": 1,
                        "dimension_unit": "m",
                        "batch_number_management_indicator": true,
                        "minimum_remaining_shelf_life": 90,
                        "total_shelf_life": 365,
                        "materialDataPerWarehouse": {
                            "loading_equipment_quantity": 5,
                            "storage_unit_type": "pal"
                        },
                        "materialUnitOfMeasure": {
                            "unit_of_measure_for_stockkeeping_unit": "box",
                            "numerator_for_conversion_to_base_units_of_measure": 1,
                            "denominator_for_conversion_to_base_units_of_measure": 12
                        },
                        "materialC": {
                            "abc_indicator": "a",
                            "maximum_storage_period": 90,
                            "post_to_inspection_stock": true,
                            "commodity_code": "12345678901234567",
                            "serial_number_profile": "1000"
                        },
                        "materialShortText": {
                            "language_key": "en",
                            "material_description": "Steel Plate"
                        },
                        "materialHazardous": {
                            "valid_to": null,
                            "parked": null,
                            "last_changed_on": null,
                            "material_number": null,
                            "mode_of_transport_category_for_dangerous_goods": null,
                            "no_dangerous_goods": null,
                            "un_number": null,
                            "primary_hazard_inducing_substance": null,
                            "secondary_hazard_inducing_substance": null,
                            "dangerous_goods_category": null,
                            "aggregate_state_at_transportation": null,
                            "flash_point": null,
                            "hazard_note_1": null,
                            "hazard_note_2": null,
                            "hazard_note_3": null,
                            "hazard_note_4": null,
                            "hazard_note_5": null,
                            "hazard_note_6": null,
                            "hazard_note_7": null,
                            "hazard_note_8": null,
                            "hazard_note_9": null,
                            "hazard_note_10": null,
                            "water_hazard_class": null,
                            "flammable_liquids_ordinance_class": null,
                            "storage_hazard_class": null,
                            "accident_procedures_sheet_number_1": null,
                            "accident_procedures_sheet_number_2": null,
                            "maximal_quantity_per_transport_unit": null,
                            "packing_group": null,
                            "hazard_id_number": null,
                            "hazard_label_1": null,
                            "hazard_label_2": null,
                            "hazard_label_3": null,
                            "hazard_label_4": null,
                            "label_number_1": null,
                            "label_number_2": null,
                            "label_number_3": null,
                            "label_number_4": null,
                            "label_number_5": null,
                            "label_number_6": null,
                            "label_number_7": null,
                            "label_number_8": null,
                            "label_number_9": null,
                            "label_number_10": null,
                            "hazardousPackaging": {
                                "package_code": null
                            },
                            "hazardousMarine": {
                                "marine_pollutant": null
                            },
                            "hazardousLimit": {
                                "reportable_quantity": null,
                                "quantity_unit_of_reportable_quantities": null,
                                "exempted_quantity": null,
                                "transport_not_permitted": null
                            }
                        }
                    }
                }
            ]
        },
        {
            "id": 2,
            "status": "pending",
            "ordered_at": "2024-12-07T09:38:03.000000Z",
            "sscc": "123456789",
            "customer": {
                "user": {
                    "id": 25,
                    "name": "Vivian Massey",
                    "email": "lexizuf@mailinator.com",
                    "phone_number_business": null,
                    "job_title": null,
                    "locale": "de"
                },
                "company": {
                    "id": 5,
                    "name": "Henry Calderon",
                    "address_line_1": "38 East Milton Drive",
                    "address_line_2": "Tor 5",
                    "postal_code": "12345",
                    "city": "München",
                    "country": "DE",
                    "phone": "+1 (155) 279-3646",
                    "email": "company@mailinator.com",
                    "billing_email": "billing@mailinator.com",
                    "website": "https://www.company.com"
                }
            },
            "warehouse": {
                "id": 3,
                "name": "Falcon 3",
                "address_line_1": "Pfaffenstr. 38",
                "address_line_2": "Domenico Waldherr",
                "postal_code": "74078",
                "city": "Heilbronn",
                "country": "DE",
                "phone": "01726378044",
                "sales_mail": [
                    "Domenico.Waldherr@Fritz-Gruppe.de"
                ],
                "contact_mail": [
                    "Domenico.Waldherr@Fritz-Gruppe.de"
                ]
            },
            "order_material": [
                {
                    "id": 2,
                    "quantity": 2000,
                    "unit_of_measure": "Liter",
                    "material": {
                        "material_number": "B12345678901234567",
                        "material_type": "roh",
                        "base_unit_of_measure": "m",
                        "gross_weight": 1000,
                        "net_weight": 980,
                        "weight_unit": "kg",
                        "volume": 1,
                        "volume_unit": "m3",
                        "temperature_conditions_indicator": "c",
                        "international_article_number": "9783161484100",
                        "length": 2.5,
                        "width": 1.2,
                        "height": 1,
                        "dimension_unit": "m",
                        "batch_number_management_indicator": true,
                        "minimum_remaining_shelf_life": 90,
                        "total_shelf_life": 365,
                        "materialDataPerWarehouse": {
                            "loading_equipment_quantity": 5,
                            "storage_unit_type": "pal"
                        },
                        "materialUnitOfMeasure": {
                            "unit_of_measure_for_stockkeeping_unit": "box",
                            "numerator_for_conversion_to_base_units_of_measure": 1,
                            "denominator_for_conversion_to_base_units_of_measure": 12
                        },
                        "materialC": {
                            "abc_indicator": "a",
                            "maximum_storage_period": 90,
                            "post_to_inspection_stock": true,
                            "commodity_code": "12345678901234567",
                            "serial_number_profile": "1000"
                        },
                        "materialShortText": {
                            "language_key": "en",
                            "material_description": "Steel Plate"
                        },
                        "materialHazardous": {
                            "valid_to": "2025-12-07 00:00:00",
                            "parked": false,
                            "last_changed_on": "2024-11-07 00:00:00",
                            "material_number": "A12345678901234567",
                            "mode_of_transport_category_for_dangerous_goods": "4",
                            "no_dangerous_goods": false,
                            "un_number": "3077",
                            "primary_hazard_inducing_substance": "Acetone",
                            "secondary_hazard_inducing_substance": "Ethanol",
                            "dangerous_goods_category": "2",
                            "aggregate_state_at_transportation": "l",
                            "flash_point": 23.5,
                            "hazard_note_1": "H220",
                            "hazard_note_2": "H315",
                            "hazard_note_3": "H302",
                            "hazard_note_4": "H314",
                            "hazard_note_5": "H317",
                            "hazard_note_6": "H334",
                            "hazard_note_7": "H335",
                            "hazard_note_8": "H370",
                            "hazard_note_9": "H371",
                            "hazard_note_10": "H372",
                            "water_hazard_class": "2",
                            "flammable_liquids_ordinance_class": "h225",
                            "storage_hazard_class": "1",
                            "accident_procedures_sheet_number_1": "AP-001",
                            "accident_procedures_sheet_number_2": "AP-002",
                            "maximal_quantity_per_transport_unit": "2",
                            "packing_group": "i",
                            "hazard_id_number": "33",
                            "hazard_label_1": "3",
                            "hazard_label_2": "6.1",
                            "hazard_label_3": "8",
                            "hazard_label_4": "9",
                            "label_number_1": "3",
                            "label_number_2": "6.1",
                            "label_number_3": "8",
                            "label_number_4": "9",
                            "label_number_5": "3",
                            "label_number_6": "6.1",
                            "label_number_7": "8",
                            "label_number_8": "9",
                            "label_number_9": "3",
                            "label_number_10": "6.1",
                            "hazardousPackaging": {
                                "package_code": "3H2"
                            },
                            "hazardousMarine": {
                                "marine_pollutant": 0
                            },
                            "hazardousLimit": {
                                "reportable_quantity": 1000,
                                "quantity_unit_of_reportable_quantities": "kg",
                                "exempted_quantity": 5,
                                "transport_not_permitted": false
                            }
                        }
                    }
                }
            ]
        }
    ],
    "links": {
        "first": "https://warespace.ddev.site:8443/api/warespace/v1/public/ecl/orders?page=1",
        "last": "https://warespace.ddev.site:8443/api/warespace/v1/public/ecl/orders?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "« Vorherige",
                "active": false
            },
            {
                "url": "https://warespace.ddev.site:8443/api/warespace/v1/public/ecl/orders?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Nächste »",
                "active": false
            }
        ],
        "path": "https://warespace.ddev.site:8443/api/warespace/v1/public/ecl/orders",
        "per_page": 20,
        "to": 1,
        "total": 1
    }
}
{
    "message": "Unauthenticated."
}

Store a confirmation for an order

POST
https://warespace.de
/api/warespace/v1/company/ecl/orders/{order}/confirmation
requires authentication

This endpoint stores a confirmation for an order.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

order
string
required

The order number or id

Example:
52000-38103-1

Body Parameters

Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/company/ecl/orders/52000-38103-1/confirmation" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"document_date\": \"2024-12-07\",
    \"reference_document_number\": \"REF12345\",
    \"user_name\": \"johndoe\",
    \"document_header_text\": \"Delivery Order\",
    \"items\": [
        {
            \"material_number\": \"MATERIAL12345\",
            \"plant\": \"PL01\",
            \"storage_location\": \"ST01\",
            \"batch_number\": \"BATCH123\",
            \"stock_type\": true,
            \"entry_quantity\": 100,
            \"entry_quantity_unit\": \"kg\",
            \"purchase_order_number\": \"PO12345\",
            \"position_item\": \"POS1\",
            \"shipping_instructions\": \"SI\",
            \"position_text\": \"Item description\",
            \"order_number\": \"ORD12345\",
            \"order_position_number\": \"1\",
            \"expiration_date\": \"2024-12-31\",
            \"delivery_number\": \"DEL12345\",
            \"delivery_position\": \"1\",
            \"serial_numbers\": [
                {
                    \"serial_number\": \"SN123456789\"
                }
            ]
        }
    ]
}"
Example response : 
{
    "data": "ok"
}
{
    "message": "Unauthenticated."
}
{
    "message": "Order not found"
}
{
    "message": "Validation failed",
    "errors": {
        "document_date": [
            "The document_date field must be a valid date."
        ],
        "items.0.material_number": [
            "The material_number field is required."
        ]
    }
}

Store multiple pallets in storage

POST
https://warespace.de
/api/warespace/v1/company/ecl/orders/{order}/pallets
requires authentication

This endpoint allows you to add multiple pallets for an order. Each pallet contains details such as dimensions, weight, and type.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

order
string
required

The order number or id.

Example:
52000-38103-1

Body Parameters

Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/company/ecl/orders/52000-38103-1/pallets" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"pallets\": [
        {
            \"external_load_carrier_id\": \"LOAD12345\",
            \"type\": \"euro_pallet\",
            \"length\": 120,
            \"width\": 80,
            \"height\": 14.5,
            \"dimension_unit\": \"cm\",
            \"weight\": 25,
            \"weight_unit\": \"kg\",
            \"inbound_date\": \"2024-12-07\"
        }
    ]
}"
Example response : 
{
    "data": "ok"
}
{
    "message": "Unauthenticated."
}
{
    "message": "Order not found"
}
{
    "message": "Validation failed",
    "errors": {
        "pallets.0.type": [
            "The type field is invalid."
        ],
        "pallets.0.length": [
            "The length field must be numeric."
        ]
    }
}

Public

Transport Offers for Palletspace

APIs for fetching transport offers

APIs for fetching transport offers


Fetch the prices for the transport offers

GET
https://warespace.de
/api/palletspace/v1/public/transport-offer
requires authentication

This endpoint gives you the prices for the transport offers.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

status
string

Status to filter by. Possible options are requested, cancelled, inbound, stock, outsourced, quality_issue, fulfilled

Example:
stock
page
integer

Current page number. Defaults to '1'.

Example:
5
page_size
integer

Size of a page. Defaults to '100'.

Example:
20
Example request: 
curl --request GET \
    --get "https://warespace.de/api/palletspace/v1/public/transport-offer?status=stock&page=5&page_size=20" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": {
        "id": "clvws3283005y4rb67rhcu4c8",
        "costItems": [
            {
                "description": "Frachtkosten",
                "type": "SHIPMENT",
                "subtype": null,
                "price": {
                    "amount": 901.89,
                    "currency": "EUR"
                }
            },
            {
                "description": "Klimaneutraler Versand / CO2 Offset",
                "type": "CLIMATE_NEUTRAL_SURCHARGE",
                "subtype": null,
                "price": {
                    "amount": 56.84,
                    "currency": "EUR"
                }
            }
        ],
        "pickupOn": "2024-05-27T06:00:00.000Z",
        "pickupAtFrom": "2024-05-27T06:00:00.000Z",
        "pickupAtUntil": "2024-05-29T14:00:00.000Z",
        "price": {
            "amount": 958.73,
            "currency": "EUR",
            "grossAmount": 1140.89,
            "vat": 182.16
        },
        "priceStandard": {
            "amount": 958.73,
            "currency": "EUR"
        },
        "runtime": {
            "daysMin": 5,
            "daysMax": 8
        },
        "delivery": {
            "earliest": "2024-06-03T06:00:00.000Z",
            "latest": "2024-06-06T14:00:00.000Z"
        },
        "product": "STANDARD",
        "truckType": "DIRECT_TRUCK_40",
        "transportType": "FULL_LOAD",
        "co2Emission": {
            "amount": 56.84,
            "value": 2870.68,
            "unit": "KG"
        }
    },
    "links": [
        {
            "description": "Get another quotation.",
            "href": "https://api-sandbox.cargoboard.com/v1/quotations",
            "method": "POST",
            "rel": "self"
        },
        {
            "rel": "quotationBook",
            "method": "POST",
            "description": "Book transport based on this quotation.",
            "href": "https://api-sandbox.cargoboard.com/v1/quotations/clvws3283005y4rb67rhcu4c8/book"
        }
    ]
}
{
    "message": "The given loads are too heavy. Up to 24000 kg are allowed, but 29700 kg were given.",
    "error": "Unprocessable Entity",
    "statusCode": 422
}

Warehouse

APIs for fetching warehouses

APIs for managing warehouses


Display a listing of the Warehouses

GET
https://warespace.de
/api/warespace/v1/public/warehouses

This endpoint gives you all the warehouses.

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

page
integer

Current page number. Defaults to '1'.

Example:
5
page_size
integer

Size of a page. Defaults to '100'.

Example:
20
postal_code
string

Postal code to filter by. Defaults to 'null'.

Example:
12345
ids
integer[]

Ids to filter by. Defaults to 'null'.

Example:
[1,2]
pattern
string

Pattern to filter by. Defaults to 'null'.

Example:
Logistikzentrum Leipzig
pallet_height
integer

Pallet height to filter by. Defaults to 'null'.

Example:
120
inbound
string

Inbound date to filter by (Y-m-d). Defaults to 'null'.

Example:
2024-02-01
outbound
string

Outbound date to filter by (Y-m-d). Defaults to 'null'.

Example:
2024-02-02
voucher
string

Voucher code which will be applied to the prices. Defaults to 'null'.

Example:
CARGOBOARD15
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/public/warehouses?page=5&page_size=20&postal_code=12345&ids[]=1&ids[]=2&pattern=Logistikzentrum+Leipzig&pallet_height=120&inbound=2024-02-01&outbound=2024-02-02&voucher=CARGOBOARD15" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "id": 1,
            "name": "Born Steiner AG & Co. KGaB",
            "zip": "25735",
            "city": "Celle",
            "country": "DE",
            "capacity": 821,
            "inboundPrice": 16.94,
            "highRackStorageFee": 6.87,
            "blockStorageFee": 0.5,
            "outboundPrice": 12.51,
            "geometry": {
                "coordinates": [
                    51.710762,
                    15.386749
                ]
            },
            "properties": {
                "maxPalletHeightInRackStorage": 86,
                "maxPalletWeightInRackStorage": 182,
                "maxPalletLengthInRackStorage": 1200,
                "maxPalletWidthInRackStorage": 800,
                "maxPalletPositionsPalletspace": 1000,
                "visibility": {
                    "isActiveLocationProfile": false
                }
            },
            "locationProfileUrl": {
                "is_active_location_profile": true,
                "has_media_warehouse_images": true,
                "slug_company": "guenther-gmbh",
                "slug_warehouse": "region-wolfsburg"
            },
            "features": [
                "barrier-free",
                "forklift",
                "ramp"
            ]
        },
        {
            "id": 2,
            "name": "Günther GmbH",
            "zip": "04088",
            "city": "Wolfsburg",
            "country": "DE",
            "capacity": 592,
            "inboundPrice": 27.16,
            "highRackStorageFee": 0.37,
            "blockStorageFee": 0.5,
            "outboundPrice": 79.58,
            "geometry": {
                "coordinates": [
                    54.775493,
                    14.573208
                ]
            },
            "properties": {
                "maxPalletHeightInRackStorage": 86,
                "maxPalletWeightInRackStorage": 182,
                "maxPalletLengthInRackStorage": 1200,
                "maxPalletWidthInRackStorage": 800,
                "maxPalletPositionsPalletspace": 1000,
                "visibility": {
                    "isActiveLocationProfile": true
                }
            },
            "locationProfileUrl": {
                "is_active_location_profile": true,
                "has_media_warehouse_images": true,
                "slug_company": "guenther-gmbh",
                "slug_warehouse": "region-wolfsburg"
            },
            "features": [
                "sprinkler",
                "alarm",
                "camera"
            ]
        }
    ]
}
{
    "error": {
        "page": [
            "The page field must be at least 1."
        ],
        "page_size": [
            "The page size field must be at least 1."
        ]
    }
}
{
    "error": "The server has missing file permissions."
}

Display a listing of the nearest Warehouses

GET
https://warespace.de
/api/warespace/v1/public/nearest-warehouses

This endpoint gives you all the nearest warehouses.

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

page
integer

Current page number. Defaults to '1'.

Example:
5
page_size
integer

Size of a page. Defaults to '100'.

Example:
20
postal_code
string

Postal code to filter by. Defaults to 'null'.

Example:
12345
ids
integer[]

Ids to filter by. Defaults to 'null'.

Example:
[1,2]
pattern
string

Pattern to filter by. Defaults to 'null'.

Example:
Logistikzentrum Leipzig
pallet_height
integer

Pallet height to filter by. Defaults to 'null'.

Example:
120
inbound
string

Inbound date to filter by (Y-m-d). Defaults to 'null'.

Example:
2024-02-01
outbound
string

Outbound date to filter by (Y-m-d). Defaults to 'null'.

Example:
2024-02-02
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/public/nearest-warehouses?page=5&page_size=20&postal_code=12345&ids[]=1&ids[]=2&pattern=Logistikzentrum+Leipzig&pallet_height=120&inbound=2024-02-01&outbound=2024-02-02" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "id": 1,
            "name": "Born Steiner AG & Co. KGaB",
            "zip": "25735",
            "city": "Celle",
            "country": "DE",
            "capacity": 821,
            "inboundPrice": 16.94,
            "highRackStorageFee": 6.87,
            "blockStorageFee": 0.5,
            "outboundPrice": 12.51,
            "geometry": {
                "coordinates": [
                    51.710762,
                    15.386749
                ]
            },
            "properties": {
                "maxPalletHeightInRackStorage": 86,
                "maxPalletWeightInRackStorage": 182,
                "maxPalletLengthInRackStorage": 1200,
                "maxPalletWidthInRackStorage": 800,
                "maxPalletPositionsPalletspace": 1000,
                "visibility": {
                    "isActiveLocationProfile": false
                }
            },
            "locationProfileUrl": {
                "is_active_location_profile": true,
                "has_media_warehouse_images": true,
                "slug_company": "guenther-gmbh",
                "slug_warehouse": "region-wolfsburg"
            },
            "features": [
                "heatable",
                "sprinkler",
                "alarm"
            ]
        },
        {
            "id": 2,
            "name": "Günther GmbH",
            "zip": "04088",
            "city": "Wolfsburg",
            "country": "DE",
            "capacity": 592,
            "inboundPrice": 27.16,
            "highRackStorageFee": 0.37,
            "blockStorageFee": 0.5,
            "outboundPrice": 79.58,
            "geometry": {
                "coordinates": [
                    54.775493,
                    14.573208
                ]
            },
            "properties": {
                "maxPalletHeightInRackStorage": 86,
                "maxPalletWeightInRackStorage": 182,
                "maxPalletLengthInRackStorage": 1200,
                "maxPalletWidthInRackStorage": 800,
                "maxPalletPositionsPalletspace": 1000,
                "visibility": {
                    "isActiveLocationProfile": true
                }
            },
            "locationProfileUrl": {
                "is_active_location_profile": true,
                "has_media_warehouse_images": true,
                "slug_company": "guenther-gmbh",
                "slug_warehouse": "region-wolfsburg"
            },
            "features": [
                "sprinkler",
                "alarm",
                "camera"
            ]
        }
    ]
}
{
    "error": "The server has missing file permissions."
}

Warehouse Coordinates

APIs for fetching warehouse coordinates

APIs for managing warehouse coordinates


Display a listing of the Warehouse Coordinates

GET
https://warespace.de
/api/warespace/v1/public/warehouse-coordinates

This endpoint gives you the coordinates of all the warehouses.

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

page
integer

Current page number. Defaults to '1'.

Example:
5
page_size
integer

Size of a page. Defaults to '100'.

Example:
20
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/public/warehouse-coordinates?page=5&page_size=20" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": {
        "coordinates": {
            "lat": 49.729915,
            "lng": 11.9233
        },
        "address": {
            "name": "Warehouse 1",
            "address_line_1": "Hauptstraße 1",
            "city": "Nürnberg",
            "zip": "90478",
            "country": "DE"
        },
        "company": {
            "name": "Mustermann GmbH"
        },
        "locationProfileUrl": {
            "is_active_location_profile": true,
            "has_media_warehouse_images": true,
            "slug_company": "guenther-gmbh",
            "slug_warehouse": "region-wolfsburg"
        }
    }
}
{
    "error": {
        "page": [
            "The page field must be at least 1."
        ],
        "page_size": [
            "The page size field must be at least 1."
        ]
    }
}
{
    "error": "The server has missing file permissions."
}

Partner

APIs for fetching partner companies

APIs for managing partner companies


Display a listing of the Partner Companies.

GET
https://warespace.de
/api/warespace/v1/public/company-partners

This endpoint gives you all the partner companies.

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

page
integer

Current page number. Defaults to '1'.

Example:
1
page_size
integer

Size of a page. Defaults to '100'.

Example:
20
ids
integer[]

Ids to filter by. Defaults to 'null'.

Example:
[1,2]
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/public/company-partners?page=1&page_size=20&ids[]=1&ids[]=2" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "id": 1,
            "name": "Lagerhaus Celle",
            "slug": "lagerhaus-celle",
            "media": [
                {
                    "id": 1,
                    "url": "https://example.com/image.svg"
                }
            ]
        },
        {
            "id": 2,
            "name": "Lagerhaus an der Elbe",
            "slug": "lagerhaus-an-der-elbe",
            "media": [
                {
                    "id": 2,
                    "url": "https://example.com/logo.svg"
                }
            ]
        }
    ]
}
{
    "error": {
        "page": [
            "The page field must be at least 1."
        ],
        "page_size": [
            "The page size field must be at least 1."
        ]
    }
}
{
    "error": "The server has missing file permissions."
}

General Stats

APIs for fetching general statistics

APIs for managing general statistics


Chart

GET
https://warespace.de
/api/warespace/v1/public/general-stats

Monthly chart of companies, warehouses, users and orders

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/public/general-stats" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": {
        "companies": [
            {
                "count": 31,
                "date": "2024-05"
            },
            {
                "count": 40,
                "date": "2024-06"
            }
        ],
        "warehouses": [
            {
                "count": 31,
                "date": "2024-05"
            },
            {
                "count": 40,
                "date": "2024-06"
            }
        ],
        "users": [
            {
                "count": 31,
                "date": "2024-05"
            },
            {
                "count": 40,
                "date": "2024-06"
            }
        ],
        "orders": [
            {
                "count": 31,
                "date": "2024-05"
            },
            {
                "count": 40,
                "date": "2024-06"
            }
        ],
        "warehouseCapacity": {
            "08.07.2024": 1000,
            "09.07.2024": 1500,
            "10.07.2024": 2000
        }
    }
}
{
    "error": "The server has missing file permissions."
}

Locales

APIs for fetching locales

APIs for managing locales


Display a listing of the Locales

GET
https://warespace.de
/api/warespace/v1/public/locales

This endpoint gives you all the locales.

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/public/locales" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "code": "de",
            "name": "Deutsch",
            "flag": "https://www.example.com/flag-de.svg",
            "default": true
        },
        {
            "code": "en",
            "name": "English",
            "flag": "https://www.example.com/flag-en.svg",
            "default": false
        }
    ]
}
{
    "error": "The server has missing file permissions."
}

Load Carrier Types

APIs for fetching load carrier types

APIs for managing load carrier types


Display a listing of the load carrier types.

GET
https://warespace.de
/api/warespace/v1/public/load-carrier-types

This endpoint gives you all the load carrier types.

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/public/load-carrier-types" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "name": "euro_pallet",
            "value": "Euro pallet"
        },
        {
            "name": "half_pallet",
            "value": "Half pallet"
        },
        {
            "name": "pallet_cage",
            "value": "Pallet cage"
        },
        {
            "name": "one_way_pallet",
            "value": "One way pallet"
        },
        {
            "name": "wood_box_or_flight_case",
            "value": "Wood box or flight case"
        }
    ]
}
{
    "error": "The server has missing file permissions."
}

Contact request

APIs for creating and managing contact requests

APIs for managing contact requests


Store a contact request

POST
https://warespace.de
/api/warespace/v1/public/contact-request

This endpoint allows you to store a contact request. Use "Accept-Language" header to specify the language of the email, which the user will receive.

Headers

Accept-Language
Example:
de
Content-Type
Example:
application/json
Accept
Example:
application/json

Body Parameters

Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/public/contact-request" \
    --header "Accept-Language: de" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"Max Mustermann\",
    \"email\": \"max@mustermann.de\",
    \"message\": \"I would like to know more about your services\",
    \"preferred_contact_method\": \"email\",
    \"phone\": \"+49123456789\",
    \"company_name\": \"Example Inc.\"
}"
Example response : 
{
    "data": "ok"
}
{
    "message": "Das Feld name ist erforderlich.",
    "errors": {
        "name": [
            "Das Feld name ist erforderlich."
        ]
    }
}

Newsletter

APIs for creating and managing newsletters

APIs for managing newsletters


Store a newsletter request

POST
https://warespace.de
/api/warespace/v1/public/newsletter

This endpoint allows you to store a contact in the newsletter model. Use "Accept-Language" header to specify the locale.

Headers

Accept-Language
Example:
de
Content-Type
Example:
application/json
Accept
Example:
application/json

Body Parameters

Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/public/newsletter" \
    --header "Accept-Language: de" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"max@mustermann.de\",
    \"name\": \"Max Mustermann\",
    \"purpose\": \"Waiting list for external logisticians\",
    \"metadata\": \"This email is used as support mail\",
    \"company_name\": \"Mustermann GmbH\",
    \"phone\": \"+49123456789\"
}"
Example response :

Blog

APIs for fetching blog posts

APIs for managing blog posts


Display a listing of the Warehouses

GET
https://warespace.de
/api/warespace/v1/public/blog

This endpoint gives you all the warehouses.

Headers

Accept-Language
Example:
de
Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

page
integer

Current page number. Defaults to '1'.

Example:
5
page_size
integer

Size of a page. Defaults to '100'.

Example:
20
locale
string

Locale of the blog posts: de, en, etc.

Example:
de
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/public/blog?page=5&page_size=20&locale=de" \
    --header "Accept-Language: de" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "id": 1,
            "title": "Lerne mehr über Logistik-Strategien",
            "description": "Erfahre mehr über die neuesten Logistik-Strategien und wie du sie für dein Unternehmen nutzen kannst.",
            "imageUrl": "https://example.com/image.jpg",
            "datetime": "d.m.Y H:i:s",
            "href": "https://example.com/blog/1"
        },
        {
            "id": 2,
            "title": "Die Zukunft der Logistik",
            "description": "Erfahre mehr über die Zukunft der Logistik und wie du dich darauf vorbereiten kannst.",
            "imageUrl": "https://example.com/image.jpg",
            "datetime": "d.m.Y H:i:s",
            "href": "https://example.com/blog/2"
        },
        {
            "id": 3,
            "title": "Die Vorteile von Logistik-Software",
            "description": "Erfahre mehr über die Vorteile von Logistik-Software und wie sie dein Unternehmen verbessern kann.",
            "imageUrl": "https://example.com/image.jpg",
            "datetime": "d.m.Y H:i:s",
            "href": "https://example.com/blog/3"
        }
    ]
}
{
    "error": {
        "page": [
            "The page field must be at least 1."
        ],
        "page_size": [
            "The page size field must be at least 1."
        ]
    }
}
{
    "error": "The server has missing file permissions."
}

User Authentication

Palletspace Orders

APIs for managing orders

APIs for managing orders


Display a listing of all orders

GET
https://warespace.de
/api/palletspace/v1/user/orders
requires authentication

This endpoint gives you a listing of the palletspace orders for a user.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

Query Parameters

status
string

Status to filter by. Possible options are requested, cancelled, inbound, stock, outsourced, quality_issue, fulfilled

Example:
stock
page
integer

Current page number. Defaults to '1'.

Example:
5
page_size
integer

Size of a page. Defaults to '100'.

Example:
20
Example request: 
curl --request GET \
    --get "https://warespace.de/api/palletspace/v1/user/orders?status=stock&page=5&page_size=20" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "id": 1,
            "orderNumber": "1722-0885-5626",
            "orderNumberUUID": "6b885e57-c75a-3452-a067-9c2825fbab8b",
            "createdAt": "2021-09-17",
            "createdBy": "John Doe",
            "warehouses": [
                {
                    "id": 24,
                    "name": "Location Name A",
                    "urlSlug": "location-name-a",
                    "pallets": 12344,
                    "inboundDate": "2021-10-01",
                    "outboundDate": "2021-10-02",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    },
                    "canCancel": true,
                    "cancelHasExpired": true
                },
                {
                    "id": 45,
                    "name": "Location Name B",
                    "urlSlug": "location-name-b",
                    "pallets": 233,
                    "inboundDate": "2023-01-31",
                    "outboundDate": "2023-07-08",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    },
                    "canCancel": true,
                    "cancelHasExpired": true
                },
                {
                    "id": 657,
                    "name": "Location Name C",
                    "urlSlug": "location-name-c",
                    "pallets": 233,
                    "inboundDate": "2023-10-01",
                    "outboundDate": "2023-11-20",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    },
                    "canCancel": true,
                    "cancelHasExpired": true
                }
            ],
            "canCancel": true,
            "cancelHasExpired": true
        },
        {
            "id": 2,
            "orderNumber": "1722-0885-5626",
            "orderNumberUUID": "6b885e57-c75a-3452-a067-9c2825fbab8b",
            "createdAt": "2023-08-29",
            "createdBy": "Jane Doe",
            "warehouses": [
                {
                    "id": 767,
                    "name": "Location Name A",
                    "urlSlug": "location-name-a",
                    "pallets": 12344,
                    "inboundDate": "2021-10-01",
                    "outboundDate": "2021-10-02",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    },
                    "canCancel": true,
                    "cancelHasExpired": true
                }
            ],
            "canCancel": true,
            "cancelHasExpired": true
        },
        {
            "id": 3,
            "orderNumber": "1722-0885-5626",
            "orderNumberUUID": "6b885e57-c75a-3452-a067-9c2825fbab8b",
            "createdAt": "2021-09-12",
            "createdBy": "John Doe",
            "warehouses": [
                {
                    "id": 8,
                    "name": "Location Name A",
                    "urlSlug": "location-name-a",
                    "pallets": 12344,
                    "inboundDate": "2020-09-31",
                    "outboundDate": "2021-10-09",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    },
                    "canCancel": true,
                    "cancelHasExpired": true
                },
                {
                    "id": 96,
                    "name": "Location Name B",
                    "urlSlug": "location-name-b",
                    "pallets": 233,
                    "inboundDate": "2023-04-01",
                    "outboundDate": "2023-07-07",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    },
                    "canCancel": true,
                    "cancelHasExpired": true
                },
                {
                    "id": 2,
                    "name": "Location Name C",
                    "urlSlug": "location-name-c",
                    "pallets": 233,
                    "inboundDate": "2023-10-01",
                    "outboundDate": "2023-11-20",
                    "status": {
                        "label": "Stock",
                        "value": "stock"
                    },
                    "transport": {
                        "status": {
                            "label": "Requested",
                            "value": "requested"
                        }
                    },
                    "canCancel": true,
                    "cancelHasExpired": true
                }
            ],
            "canCancel": true,
            "cancelHasExpired": true
        }
    ]
}
{
    "message": "Unauthenticated."
}

Cancel a palletspace order

POST
https://warespace.de
/api/palletspace/v1/user/orders/cancel/{order_order_number_uuid}/warehouse/{warehouse_id}
requires authentication

This endpoint allows you to cancel a palletspace order.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

order_order_number_uuid
string
required
Example:
1e83cb6b-cc49-3191-af78-6496bc01091f
warehouse_id
integer
required

The ID of the warehouse.

Example:
1
Example request: 
curl --request POST \
    "https://warespace.de/api/palletspace/v1/user/orders/cancel/1e83cb6b-cc49-3191-af78-6496bc01091f/warehouse/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "message": "Order cancelled successfully."
}
{
    "message": "Order already cancelled."
}
{
    "message": "Unauthenticated."
}
{
    "message": "Unauthorized."
}
{
    "message": "Order not found."
}

User

APIs for managing users

APIs for managing users


Display the authenticated user

GET
https://warespace.de
/api/warespace/v1/user/user
requires authentication

This endpoint gives you the authenticated user.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/user/user" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "id": 1,
    "name": "Max Mustermann",
    "email": "max.mustermann@email.de",
    "email_verified_at": "2024-04-17T14:52:54.000000Z",
    "two_factor_confirmed_at": null,
    "current_team_id": null,
    "profile_photo_path": null,
    "created_at": "2024-04-17T14:52:54.000000Z",
    "updated_at": "2024-04-17T14:52:54.000000Z",
    "company_id": null,
    "force_password_change": false,
    "profile_photo_url": "https://ui-avatars.com/api/?name=Max+Mustermann&color=7F9CF5&background=EBF4FF",
    "company": null
}
{
    "message": "Unauthenticated."
}

Notification

APIs for managing user notifications

APIs for managing user notifications


Display the unread notifications.

GET
https://warespace.de
/api/warespace/v1/user/notifications
requires authentication

This endpoint gives you the unread notifications of the authenticated user.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/user/notifications" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
[
    {
        "id": "0f2b7c8c-711f-4e79-bd7d-7bc7d380bc23",
        "type": "App\\Notifications\\NewFollower",
        "notifiable_type": "App\\Models\\User",
        "notifiable_id": 51,
        "data": {
            "title": "Einladung von Reiter Reinhardt KGaA",
            "route": "https://example.com/dashboard/notifications"
        },
        "read_at": null,
        "created_at": "2021-08-25T09:00:00.000000Z",
        "updated_at": "2021-08-25T09:00:00.000000Z"
    },
    {
        "id": "1f2b7c8c-711f-4e79-bd7d-7bc7d380bc23",
        "type": "App\\Notifications\\NewFollower",
        "notifiable_type": "App\\Models\\User",
        "notifiable_id": 53,
        "data": {
            "title": "Einladung von Reiter Reinhardt KGaA",
            "route": "https://example.com/dashboard/notifications"
        },
        "read_at": "2021-08-25T09:05:00.000000Z",
        "created_at": "2021-08-25T09:00:00.000000Z",
        "updated_at": "2021-08-25T09:05:00.000000Z"
    }
]
{
    "message": "Unauthenticated."
}

Mark a notification as read.

POST
https://warespace.de
/api/warespace/v1/user/notifications/{notification}/mark-as-read
requires authentication

This endpoint marks a notification as read.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json

URL Parameters

notification
integer
required

The notification ID.

Example:
137
Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/user/notifications/137/mark-as-read" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "message": "Notification marked as read."
}
{
    "message": "Notification not found."
}

Statistics

APIs for managing user statistics

APIs for managing user statistics


Display user statistics.

GET
https://warespace.de
/api/warespace/v1/user/statistics
requires authentication

This endpoint gives you the statistics of the authenticated user.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/user/statistics" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
[
    {
        "name": "inbound",
        "stat": 2500,
        "change": 21,
        "changeType": "increase"
    },
    {
        "name": "stock",
        "stat": 23500,
        "change": 0,
        "changeType": "equal"
    },
    {
        "name": "fulfilled",
        "stat": 18282,
        "change": 3.2,
        "changeType": "decrease"
    }
]
{
    "message": "Unauthenticated."
}

Recent Order

APIs for managing recent orders

APIs for managing recent orders


Display a listing of the last recent orders

GET
https://warespace.de
/api/warespace/v1/user/recent-orders
requires authentication

This endpoint gives you a listing of the last recent orders.

Headers

Authorization
Example:
Bearer {YOUR_AUTH_KEY}
Content-Type
Example:
application/json
Accept
Example:
application/json
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/user/recent-orders" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
[
    {
        "title": "Active",
        "recentActivity": [
            {
                "invoiceNumber": "00012",
                "href": "#",
                "pallets": 2500,
                "inboundDate": "2021-10-01",
                "createdAt": "2021-09-17 12:22:05",
                "status": {
                    "label": "Requested",
                    "value": "requested"
                },
                "orderNumber": "1722-0885-5626",
                "orderNumberUUID": "6b885e57-c75a-3452-a067-9c2825fbab8b",
                "description": "Palletspace"
            },
            {
                "id": 2,
                "invoiceNumber": "00011",
                "href": "#",
                "pallets": 30,
                "inboundDate": "2023-03-22",
                "createdAt": "2023-01-17 01:02:44",
                "status": {
                    "label": "Stock",
                    "value": "stock"
                },
                "orderNumber": "1722-0885-5626",
                "orderNumberUUID": "6b885e57-c75a-3452-a067-9c2825fbab8b",
                "description": "Palletspace"
            }
        ]
    },
    {
        "title": "Fulfilled",
        "recentActivity": [
            {
                "id": 1,
                "invoiceNumber": "00009",
                "href": "#",
                "pallets": 12500,
                "inboundDate": "2023-03-22",
                "createdAt": "2023-02-11 03:22:05",
                "status": {
                    "label": "Fulfilled",
                    "value": "fulfilled"
                },
                "orderNumber": "1722-0885-5626",
                "orderNumberUUID": "6b885e57-c75a-3452-a067-9c2825fbab8b",
                "description": "Tenderspace"
            },
            {
                "id": 2,
                "invoiceNumber": "00012",
                "href": "#",
                "pallets": 500,
                "inboundDate": "2023-03-22",
                "createdAt": "2023-03-07 02:12:06",
                "status": {
                    "label": "Fulfilled",
                    "value": "fulfilled"
                },
                "orderNumber": "1722-0885-5626",
                "orderNumberUUID": "6b885e57-c75a-3452-a067-9c2825fbab8b",
                "description": "Link"
            }
        ]
    }
]
{
    "message": "Unauthenticated."
}

User Authentication

APIs for managing user authentication

APIs for managing users


Authenticate

POST
https://warespace.de
/api/warespace/v1/user/authenticate

This endpoint gives you the access token by your user credentials.

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json

Body Parameters

Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/user/authenticate" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"email\": \"pgraham@example.net\",
    \"password\": \"YUKzbYZDJ(7N\"
}"
Example response : 
{
    "access_token": "1|kOuTvtR9oJbDkOncClZdAwtg9bPRT9YDja6BgWxX4701237a"
}
{
    "message": "Invalid Credentials"
}