Create a loading

Prod Env

https://www.loadingcalendar.com/api/v1

POST

/loadings

Loadings

Creates a new loading (dock booking). The dock must belong to your company.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Loading created

Body

🟠401Unauthorized

🟠422UnprocessableEntity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://www.loadingcalendar.com/api/v1/loadings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference": "ORD-2026-001",
    "date": "2026-02-15",
    "time_from": "09:00",
    "dock_id": 0,
    "duration": 15,
    "loading_duration_id": 0,
    "supplier": "string",
    "goods": "string",
    "carrier": "string",
    "direction": "inbound",
    "notes": "string",
    "driver_name": "string",
    "driver_phone": "string",
    "registration_plate": "string",
    "carrier_email": "string",
    "documents": [
        {
            "category": "loading_plan",
            "filename": "delivery-note.pdf",
            "content_type": "application/octet-stream",
            "base64": "string"
        }
    ]
}'

Response Example

201 - Example 1

{
    "id": 0,
    "dock_id": 0,
    "dock_name": "string",
    "warehouse_id": 0,
    "warehouse_name": "string",
    "date": "2026-02-15",
    "time_from": "09:00",
    "time_to": "10:00",
    "duration": 15,
    "loading_duration_id": 0,
    "reference": "ORD-2026-001",
    "cargoson_reference": "string",
    "supplier": "string",
    "goods": "string",
    "carrier": "string",
    "direction": "inbound",
    "status": "new",
    "notes": "string",
    "driver_name": "string",
    "driver_phone": "string",
    "registration_plate": "string",
    "carrier_email": "string",
    "author_email": "string",
    "author_name": "string",
    "started_at": "2026-01-25 12:00",
    "finished_at": "2026-01-25 12:30",
    "actual_duration": 0,
    "documents": [
        {
            "id": 0,
            "category": "loading_plan",
            "filename": "delivery-note.pdf",
            "content_type": "application/pdf",
            "base64": "string"
        }
    ]
}

List loadings

Get a loading