Create an open transport request
open_requests_createCreate an open transport request so ESGO carriers can see the load, with immediate and ongoing matching against existing and new trips.
Instructions
Create an open transport request
Posts a transport request that carriers on ESGO see. ESGO matches it against existing trips right away and against every new trip later. Counts against the daily quota "open_requests_create". Not retried automatically: a repeated call creates a second request.
Required API key scope: open_requests:write.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cargo_type": "<cargo_type>",
"destination": "<destination>",
"loading_meters": "<loading_meters>",
"origin": "<origin>",
"time_windows": "<time_windows>",
"weight_kg": "<weight_kg>"
},
"name": "open_requests_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin | Yes | Origin, ideally postcode and city. | |
| weight_kg | Yes | Cargo weight in kilograms. | |
| cargo_type | Yes | Kind of cargo. | |
| destination | Yes | Destination, ideally postcode and city. | |
| service_ids | No | Required additional services (ESGO service IDs). | |
| time_windows | Yes | Pickup time windows; at least one. | |
| loading_meters | Yes | Loading meters needed (max 13.6). | |
| target_price_eur | No | Optional target price in EUR shown to carriers as orientation. | |
| cargo_description | No | Free text for the carrier. | |
| loading_requirement | No | How the cargo has to be loaded. "any" never filters; "seite" (side) and "oben" (top) exclude box bodies; "heck" means rear loading. | any |