Search matching capacity
matches_searchSearch road freight capacity that fits a shipment's origin, destination, weight, loading needs and required services. Returns route, time and free-capacity matches with non-binding price estimates.
Instructions
Search matching capacity
Finds trips whose route, time and free capacity fit your shipment. Prices are non-binding estimates; a fixed price is the standing offer of the carrier. Counts against the daily quota "matches_search".
Required API key scope: matches:read.
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": {
"destination": "<destination>",
"origin": "<origin>",
"weight_kg": "<weight_kg>"
},
"name": "matches_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin | Yes | Origin, ideally postcode and city. | |
| weight_kg | Yes | Cargo weight in kilograms. | |
| destination | Yes | Destination, ideally postcode and city. | |
| service_ids | No | Required additional services (ESGO service IDs). | |
| loading_meters | No | Loading meters needed (max 13.6). | |
| 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 |