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."
}

Visitors

APIs for managing visistors


Store Visitor Event

POST
https://warespace.de
/api/warespace/v1/public/visitor-event

Store a new warespace visitor event

Headers

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

Query Parameters

event
string
required

Event identifier (must match enum VisitorEventEventEnum)

Example:
page_view

Body Parameters

Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/public/visitor-event?event=page_view" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"event\": \"ppnefspxeynkkewumkywhijkq\",
    \"url\": \"https:\\/\\/nitzsche.info\\/sequi-aut-fugiat-ex-enim-ipsam-necessitatibus-nulla.html\",
    \"payload\": {
        \"url\": \"\\/contact\"
    }
}"
Example response : 
{
    "message": "ok",
    "data": {
        "id": 1,
        "event": "page_view",
        "payload": {
            "foo": "bar"
        },
        "created_at": "2025-05-16T12:00:00Z",
        "updated_at": "2025-05-16T12:00:00Z"
    }
}
{
    "message": "Visitor session not found"
}
{
    "message": "The given data was invalid.",
    "errors": {
        "event": [
            "The event field is required."
        ]
    }
}
{
    "message": "Visitor event not created"
}

List Visitors

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

List all warespace visitor events

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
from
string

Start date (YYYY-MM-DD)

Example:
2025-05-08
to
string

End date (YYYY-MM-DD)

Example:
2025-05-08
Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/company/visitor?page=5&page_size=20&from=2025-05-08&to=2025-05-08" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [],
    "0": 200,
    "1": "Successful response"
}
{
    "message": "You are not authorized to access this resource."
}

ECL Inbound Orders

APIs for managing orders for the easy connected logistics platform.


Display a listing of all ecl inbound orders

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

This endpoint gives you a listing of all easy connected logistics inbound orders.

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

Body Parameters

Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/company/ecl/orders/inbound?page=5&page_size=20" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"page\": 10,
    \"page_size\": 74
}"
Example response : 
{
    "data": [
        {
            "id": 1,
            "order_number": "123456",
            "status": "pending_inbound",
            "sscc": "123456789012345678",
            "quantity": 1,
            "unit_of_measure": "can",
            "documents": [
                {
                    "id": 1,
                    "url": "https://example.com/example.jpg",
                    "name": "example.jpg"
                }
            ],
            "customer": {
                "user": {
                    "id": 1,
                    "name": "Max Mustermann",
                    "email": "max@mustermann.de",
                    "phone_number_business": "+49 123 4567890",
                    "job_title": "CEO",
                    "locale": {
                        "id": 2,
                        "code": "en",
                        "name": "English"
                    }
                },
                "company": {
                    "id": 1,
                    "name": "Mustermann GmbH",
                    "address_line_1": "Musterstraße 1",
                    "address_line_2": "Musterhaus",
                    "postal_code": "12345",
                    "city": "Musterstadt",
                    "country": {
                        "id": 1,
                        "name": "Afghanistan",
                        "alpha_2_code": "AF",
                        "alpha_3_code": "AFG"
                    },
                    "locale": {
                        "id": 2,
                        "code": "en",
                        "name": "English"
                    },
                    "phone": "+49 123 4567890",
                    "email": "info@mustermann.de",
                    "billing_email": "billing@mustermann.de",
                    "website": "https://www.mustermann.de",
                    "external_client_number": "123456"
                }
            },
            "warehouse": {
                "id": 1,
                "name": "Musterlager",
                "address_line_1": "Musterstraße 1",
                "postal_code": "12345",
                "city": "Musterstadt",
                "country": {
                    "id": 1,
                    "name": "Afghanistan",
                    "alpha_2_code": "AF",
                    "alpha_3_code": "AFG"
                },
                "phone": "+49 123 4567890",
                "sales_mail": "sales@musterlager.de",
                "contact_mail": "contact@musterlager.de"
            },
            "article": {
                "id": 1,
                "company": {
                    "id": 1,
                    "name": "Mustermann GmbH",
                    "address_line_1": "Musterstraße 1",
                    "address_line_2": "Musterhaus",
                    "postal_code": "12345",
                    "city": "Musterstadt",
                    "country": {
                        "id": 1,
                        "name": "Afghanistan",
                        "alpha_2_code": "AF",
                        "alpha_3_code": "AFG"
                    },
                    "locale": {
                        "id": 2,
                        "code": "en",
                        "name": "English"
                    },
                    "phone": "+49 123 4567890",
                    "email": "info@mustermann.de",
                    "billing_email": "billing@mustermann.de",
                    "website": "https://www.mustermann.de",
                    "external_client_number": "123456"
                },
                "inbound": {
                    "id": 1,
                    "article_id": 1,
                    "abc_indicator": "b",
                    "created_at": "2021-01-01 00:00:00",
                    "updated_at": "2021-01-01 00:00:00"
                },
                "hazardous": {
                    "id": 1,
                    "created_at": "2021-01-01 00:00:00",
                    "updated_at": "2021-01-01 00:00:00"
                },
                "packagings": [
                    {
                        "id": 1,
                        "width": 20,
                        "height": 20,
                        "length": 20,
                        "volume": 8000,
                        "article_id": 1,
                        "net_weight": 1,
                        "gross_weight": 1,
                        "packaging_level": 1,
                        "base_unit_of_measure": "pcs",
                        "quantity_per_packaging_level": 1,
                        "created_at": "2021-01-01 00:00:00",
                        "updated_at": "2021-01-01 00:00:00"
                    }
                ],
                "volume_unit": "cm3",
                "weight_unit": "g",
                "bestBeforeDate": {
                    "id": 1,
                    "article_id": 1,
                    "is_mandatory": true,
                    "total_shelf_life": 365,
                    "minimum_remaining_shelf_life": 30,
                    "created_at": "2021-01-01 00:00:00",
                    "updated_at": "2021-01-01 00:00:00"
                },
                "commodityCodes": [
                    {
                        "id": 1,
                        "article_packaging_id": 1,
                        "check_required": false,
                        "commodity_code": "1234567890",
                        "commodity_code_type": "gtin",
                        "created_at": "2021-01-01 00:00:00",
                        "updated_at": "2021-01-01 00:00:00"
                    }
                ],
                "dimension_unit": "mm",
                "short_description": "Ventilator, 3-speed, 120V",
                "stock_keeping_unit": "ABC-12345-S-BL",
                "batch_number_management_indicator": false,
                "created_at": "2021-01-01T00:00:00Z",
                "updated_at": "2021-01-01T00:00:00Z"
            }
        }
    ]
}
{
    "message": "Unauthenticated."
}

Update status

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

If you want to set it an inbound order to a different status, you can use this endpoint.

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
status
string
required

The status to set the order to

Must be one of:
  • pending_inbound
  • finished
  • canceled
Example:
stocked
Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/company/ecl/orders/inbound/52000-38103-1/status/stocked" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": "ok"
}
{
    "message": "Unauthenticated."
}
{
    "message": "Order not found"
}
{
    "message": "Order is in draft status"
}

ECL Outbound Orders

APIs for managing orders for the easy connected logistics platform.


Display a listing of all ecl outbound orders.

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

This endpoint gives you a listing of ecl outbound orders.

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

Body Parameters

Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/company/ecl/orders/outbound?page=5&page_size=20" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"page\": 12,
    \"page_size\": 27
}"
Example response : 
{
    "data": [
        {
            "id": 30,
            "order_number": "52000-86588-1",
            "status": "pending_outbound",
            "outbound_date": "2025-02-19T23:00:00.000000Z",
            "customer": {
                "user": {
                    "id": 1,
                    "name": "Max Mustermann",
                    "email": "max@mustermann.de",
                    "phone_number_business": "+49 123 4567890",
                    "job_title": "CEO",
                    "locale": {
                        "id": 2,
                        "code": "en",
                        "name": "English"
                    }
                },
                "company": {
                    "id": 1,
                    "name": "Mustermann GmbH",
                    "address_line_1": "Musterstraße 1",
                    "address_line_2": "Musterhaus",
                    "postal_code": "12345",
                    "city": "Musterstadt",
                    "country": {
                        "id": 1,
                        "name": "Afghanistan",
                        "alpha_2_code": "AF",
                        "alpha_3_code": "AFG"
                    },
                    "locale": {
                        "id": 2,
                        "code": "en",
                        "name": "English"
                    },
                    "phone": "+49 123 4567890",
                    "email": "info@mustermann.de",
                    "billing_email": "billing@mustermann.de",
                    "website": "https://www.mustermann.de",
                    "external_client_number": "123456"
                }
            },
            "warehouse": {
                "id": 1,
                "name": "Musterlager",
                "address_line_1": "Musterstraße 1",
                "postal_code": "12345",
                "city": "Musterstadt",
                "country": {
                    "id": 1,
                    "name": "Afghanistan",
                    "alpha_2_code": "AF",
                    "alpha_3_code": "AFG"
                },
                "phone": "+49 123 4567890",
                "sales_mail": "sales@musterlager.de",
                "contact_mail": "contact@musterlager.de"
            },
            "items": [
                {
                    "id": 1,
                    "article": {
                        "id": 1,
                        "company": {
                            "id": 1,
                            "name": "Mustermann GmbH",
                            "address_line_1": "Musterstraße 1",
                            "address_line_2": "Musterhaus",
                            "postal_code": "12345",
                            "city": "Musterstadt",
                            "country": {
                                "id": 1,
                                "name": "Afghanistan",
                                "alpha_2_code": "AF",
                                "alpha_3_code": "AFG"
                            },
                            "locale": {
                                "id": 2,
                                "code": "en",
                                "name": "English"
                            },
                            "phone": "+49 123 4567890",
                            "email": "info@mustermann.de",
                            "billing_email": "billing@mustermann.de",
                            "website": "https://www.mustermann.de",
                            "external_client_number": "123456"
                        },
                        "inbound": {
                            "id": 1,
                            "article_id": 1,
                            "abc_indicator": "b",
                            "created_at": "2021-01-01 00:00:00",
                            "updated_at": "2021-01-01 00:00:00"
                        },
                        "hazardous": {
                            "id": 1,
                            "created_at": "2021-01-01 00:00:00",
                            "updated_at": "2021-01-01 00:00:00"
                        },
                        "packagings": [
                            {
                                "id": 1,
                                "width": 20,
                                "height": 20,
                                "length": 20,
                                "volume": 8000,
                                "article_id": 1,
                                "net_weight": 1,
                                "gross_weight": 1,
                                "packaging_level": 1,
                                "base_unit_of_measure": "pcs",
                                "quantity_per_packaging_level": 1,
                                "created_at": "2021-01-01 00:00:00",
                                "updated_at": "2021-01-01 00:00:00"
                            }
                        ],
                        "volume_unit": "cm3",
                        "weight_unit": "g",
                        "bestBeforeDate": {
                            "id": 1,
                            "article_id": 1,
                            "is_mandatory": true,
                            "total_shelf_life": 365,
                            "minimum_remaining_shelf_life": 30,
                            "created_at": "2021-01-01 00:00:00",
                            "updated_at": "2021-01-01 00:00:00"
                        },
                        "commodityCodes": [
                            {
                                "id": 1,
                                "article_packaging_id": 1,
                                "check_required": false,
                                "commodity_code": "1234567890",
                                "commodity_code_type": "gtin",
                                "created_at": "2021-01-01 00:00:00",
                                "updated_at": "2021-01-01 00:00:00"
                            }
                        ],
                        "dimension_unit": "mm",
                        "short_description": "Ventilator, 3-speed, 120V",
                        "stock_keeping_unit": "ABC-12345-S-BL",
                        "batch_number_management_indicator": false,
                        "created_at": "2021-01-01T00:00:00Z",
                        "updated_at": "2021-01-01T00:00:00Z"
                    },
                    "quantity": 1,
                    "unit_of_measure": "bag",
                    "created_at": "2021-01-01 00:00:00"
                }
            ],
            "addresses": {
                "sending": {
                    "address_line_1": "123 Main St",
                    "address_line_2": "Gate 1",
                    "postal_code": "12345",
                    "city": "Anytown",
                    "country": {
                        "id": 1,
                        "name": "Afghanistan",
                        "alpha_2_code": "AF",
                        "alpha_3_code": "AFG"
                    }
                },
                "recipient": {
                    "address_line_1": "123 Main St",
                    "address_line_2": "Gate 1",
                    "postal_code": "12345",
                    "city": "Anytown",
                    "country": {
                        "id": 1,
                        "name": "Afghanistan",
                        "alpha_2_code": "AF",
                        "alpha_3_code": "AFG"
                    }
                }
            }
        }
    ]
}
{
    "message": "Unauthenticated."
}

Update status

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

This endpoint updates the status of an outbound 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
status
string
required

The status to set the order to

Must be one of:
  • pending_outbound
  • finished
  • canceled
Example:
stocked
Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/company/ecl/orders/outbound/52000-38103-1/status/stocked" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": "ok"
}
{
    "message": "Unauthenticated."
}
{
    "message": "Order not found"
}
{
    "message": "Order is in draft status"
}

ECL Articles

APIs for managing articles for the easy connected logistics platform.


Display a listing of all ecl articles

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

This endpoint gives you a listing of ecl articles 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'. Maximum is 100.

Example:
20

Body Parameters

Example request: 
curl --request GET \
    --get "https://warespace.de/api/warespace/v1/company/ecl/articles?page=5&page_size=20" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"page\": 77,
    \"page_size\": 7
}"
Example response : 
{
    "data": [
        {
            "id": 1,
            "company": {
                "id": 1,
                "name": "Mustermann GmbH",
                "address_line_1": "Musterstraße 1",
                "address_line_2": "Musterhaus",
                "postal_code": "12345",
                "city": "Musterstadt",
                "country": {
                    "id": 1,
                    "name": "Afghanistan",
                    "alpha_2_code": "AF",
                    "alpha_3_code": "AFG"
                },
                "locale": {
                    "id": 2,
                    "code": "en",
                    "name": "English"
                },
                "phone": "+49 123 4567890",
                "email": "info@mustermann.de",
                "billing_email": "billing@mustermann.de",
                "website": "https://www.mustermann.de",
                "external_client_number": "123456"
            },
            "inbound": {
                "id": 1,
                "article_id": 1,
                "abc_indicator": "b",
                "created_at": "2021-01-01 00:00:00",
                "updated_at": "2021-01-01 00:00:00"
            },
            "hazardous": {
                "id": 1,
                "created_at": "2021-01-01 00:00:00",
                "updated_at": "2021-01-01 00:00:00"
            },
            "packagings": [
                {
                    "id": 1,
                    "width": 20,
                    "height": 20,
                    "length": 20,
                    "volume": 8000,
                    "article_id": 1,
                    "net_weight": 1,
                    "gross_weight": 1,
                    "packaging_level": 1,
                    "base_unit_of_measure": "pcs",
                    "quantity_per_packaging_level": 1,
                    "created_at": "2021-01-01 00:00:00",
                    "updated_at": "2021-01-01 00:00:00"
                }
            ],
            "volume_unit": "cm3",
            "weight_unit": "g",
            "bestBeforeDate": {
                "id": 1,
                "article_id": 1,
                "is_mandatory": true,
                "total_shelf_life": 365,
                "minimum_remaining_shelf_life": 30,
                "created_at": "2021-01-01 00:00:00",
                "updated_at": "2021-01-01 00:00:00"
            },
            "commodityCodes": [
                {
                    "id": 1,
                    "article_packaging_id": 1,
                    "check_required": false,
                    "commodity_code": "1234567890",
                    "commodity_code_type": "gtin",
                    "created_at": "2021-01-01 00:00:00",
                    "updated_at": "2021-01-01 00:00:00"
                }
            ],
            "dimension_unit": "mm",
            "short_description": "Ventilator, 3-speed, 120V",
            "stock_keeping_unit": "ABC-12345-S-BL",
            "batch_number_management_indicator": false,
            "created_at": "2021-01-01T00:00:00Z",
            "updated_at": "2021-01-01T00:00:00Z"
        }
    ]
}
{
    "message": "Unauthenticated."
}

Warehouses

APIs for managing warehouses


List Warehouses

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

List all warehouses of the authenticated company.

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/company/warehouse" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
Example response : 
{
    "data": [
        {
            "id": 5,
            "name": "Mustermann GmbH, Hermann-Löns-Straße 22, 33104 Paderborn, Deutschland",
            "internal_name": "Warehouse Paderborn",
            "address": {
                "address_line_1": "Hermann-Löns-Straße 22",
                "address_line_2": null,
                "postal_code": "33104",
                "city": "Paderborn",
                "country": "DE"
            },
            "locale": {
                "id": 1,
                "code": "de",
                "name": "German",
                "created_at": "2024-07-19T09:32:15.000000Z",
                "updated_at": "2024-07-19T09:32:15.000000Z"
            },
            "api_identifier": "lager-paderborn"
        }
    ]
}

Create or Update Capacities

POST
https://warespace.de
/api/warespace/v1/company/warehouse/{warehouse_api_identifier}/capacity
requires authentication

Create or update warehouse capacities for multiple dates.

Headers

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

URL Parameters

warehouse_api_identifier
string
required
Example:
voluptas

Body Parameters

Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/company/warehouse/voluptas/capacity" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
Example response : 
{
    "message": "Capacities created or updated successfully."
}
{
    "message": "You are not allowed to access this warehouse."
}
{
    "message": "This field is required if the parent element exists. (und 1 weiterer Fehler)",
    "errors": {
        "item.3.bookable.pallet_positions": [
            "This field is required if the parent element exists."
        ],
        "item.2.bookable.area_sqm": [
            "This field is required if the parent element exists."
        ]
    }
}

Digital Twin

Contract logistics APIs for the digital twin platform.


Customs Webhook

POST
https://warespace.de
/api/warespace/v1/company/digital-twin/container/customs
requires authentication

This endpoint receives structured customs data from incoming emails (e.g. from customs authorities) and stores them as Customs records for a container.

Headers

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

Body Parameters

Example request: 
curl --request POST \
    "https://warespace.de/api/warespace/v1/company/digital-twin/container/customs" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"mailSubject\": {
                \"referenceNumber\": \"SAV1234-560000-PO12345678-LO12345678-123456789012\",
                \"containerNumber\": \"ABCD1234567\",
                \"registrationCode\": \"202412-200\",
                \"statusAccepted\": \"Accepted\",
                \"statusReleased\": \"Released\"
            }
        },
        {
            \"mailBody\": {
                \"referenceNumber\": \"SAV1234-560000-PO12345678-LO12345678-123456789012\",
                \"eoriNumber\": \"DE1234567\",
                \"companyName\": \"Mustermann GmbH & Co. KG\",
                \"containerNumber\": \"ABCD1234567\",
                \"registrationNumber\": \"12DE3456ABC789XYZ1\",
                \"customsOfficeCode\": \"DE123456\",
                \"customsAgent\": \"System\",
                \"itemNumber\": \"1\",
                \"returnIndicatorShort\": \"N\",
                \"acceptanceDate\": \"123445678\",
                \"releaseDate\": \"12345678\",
                \"releaseTime\": \"09:28:00\",
                \"acceptanceIndicator\": \"J - Declaration accepted\",
                \"releaseIndicator\": \"J - Goods released\",
                \"inspectionIndicator\": \"0 - No inspection\",
                \"returnIndicatorFull\": \"N - Customs declaration not returned\"
            }
        }
    ]
}"
Example response : 
{
    "status": "ok"
}
{
    "error": "Invalid payload"
}

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
quantity
integer

Quantity to filter by. Defaults to '1'.

Example:
10
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&quantity=10" \
    --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
quantity
integer

Quantity to filter by. Defaults to '1'.

Example:
10
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&quantity=10" \
    --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\",
    \"companyName\": \"odit\",
    \"phone\": \"+49123456789\",
    \"company_name\": \"Mustermann GmbH\"
}"
Example response :

Blog

APIs for fetching blog posts

APIs for managing blog posts


Display a listing of all blog posts

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

This endpoint gives you a listing of all blog posts.

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

Body Parameters

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" \
    --data "{
    \"page\": 75,
    \"page_size\": 18
}"
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_url_slug}
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:
40f203d2-5f48-33fa-9472-29c0ca724a19
warehouse_url_slug
string
required

The slug of the warehouse url.

Example:
necessitatibus
Example request: 
curl --request POST \
    "https://warespace.de/api/palletspace/v1/user/orders/cancel/40f203d2-5f48-33fa-9472-29c0ca724a19/warehouse/necessitatibus" \
    --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 : 
{
    "data": [
        {
            "id": "0f2b7c8c-711f-4e79-bd7d-7bc7d380bc23",
            "type": "App\\Notifications\\InvitationNotification",
            "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\\InvitationNotification",
            "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\": \"bauch.lorenza@example.net\",
    \"password\": \"}=Sle#v\\\\\"
}"
Example response : 
{
    "access_token": "1|kOuTvtR9oJbDkOncClZdAwtg9bPRT9YDja6BgWxX4701237a"
}
{
    "message": "Invalid Credentials"
}