1. Trans.eu Api
  2. Freights section
  3. Get route details

Get route details

Down­load details of the route.

Route details are avail­able for routes cre­at­ed in your com­pa­ny.

The route-id iden­ti­fi­ca­tion num­ber in request can be obtained when cre­at­ing the route or by down­load­ing the routes list.

GET
/ext/contracts-api/v2/routes/{route-id}
Request Authorization

Every request MUST include a valid access token obtained dur­ing the user autho­riza­tion process, pro­vid­ed using the Bear­er token scheme in the Autho­riza­tion head­er.

Request

Request Head­er

Successful Response

Response Fields

Response Body

Error Response

Client errors (400)

Gen­er­al API errors

Request Header
GET /ext/contracts-api/v2/routes/{route-id} HTTP/1.1 
Host: api.platform.trans.eu 
Content-Type: application/json
Accept: application/json
Authorization: Bearer {access_token) 
Api-key: {unique_app_api-key}
Response Fields
AttributeTypeExam­pleDescrip­tion
bal­anc­ingObjectRules of choice next recip­i­ents for pub­li­ca­tion
balancing.allowed_typesArray of StringsAvail­able types of bal­anc­ing: contract_condition, freight_limit, manual, percentage_share, price_ascending
balancing.dataObjectAddi­tion­al infor­ma­tion about bal­anc­ing
balancing.data.freight_limitObjectCon­fig­u­ra­tion of trans­port lim­its for freight_limit type of bal­anc­ing.
When pub­lish­ing a freight, the order of car­ri­ers will be auto­mat­i­cal­ly deter­mined so that no car­ri­er receives more or less orders than the lim­it.
balancing.data.freight_limit.maxInt10Max lim­it in %
balancing.data.freight_limit.minInt60Min lim­it in %
balancing.typeString“man­u­al”Bal­anc­ing type select­ed for route
dis­tanceObjectRoute dis­tance
distance.declaredObjectRoute dis­tance declared by user dur­ing con­fig­u­ra­tion of the route
distance.declared.unit_codeString“km”Unit code fo declared dis­tance. Default is km (kilo­me­ters)
distance.declared.valueInt150Val­ue of declared dis­tance
distance.calculatedObjectRoute dis­tance auto­mat­i­cal­ly cal­cu­lat­ed dur­ing con­fig­u­ra­tion of the route
distance.calculated.unit_codeString“km”Unit code fo cal­cu­lat­ed dis­tance. Default is km (kilo­me­ters)
distance.calculated.valueInt161Val­ue of cal­cu­lat­ed dis­tance
distance_matchObjectKilo­me­ter range for route match­ing
distance_match.maxObjectMax range
distance_match.max.unit_codeString“km”Unit code for max range. Default is km.
distance_match.max.valueInt140Val­ue of max range.
distance_match.minObjectMin range
distance_match.min.unit_codeString“km”Unit code for min range. Default is km.
distance_match.min.valueInt170Val­ue of min range.
idString“b998d30b-502d-4a50-a423-aca69aa7a756”Route id
is_roundtripBooleanFalseRound trip route
last_modification_dateString“2026–03-23T14:27:16+00:00”Last mod­i­fi­ca­tion date of def­i­n­i­tion of the route
loadsArray of ObjectsSpec­i­fi­ca­tion of loads para­me­ters required on the route
loads.amountInt1Amount of load types with­in giv­en load
loads.heightObjectLoad height
loads.height.unit_codeString“m”Unit of load height. Always is “m” (meters).
loads.height.valueFloat2.3Val­ue of load height (range 0.01–10)
loads.lengthObjectLoad length
loads.length.unit_codeString“m”Unit of load length. Always is “m” (meters)
loads.length.valueFloat1.2Val­ue of load length (range 0.01–100)
loads.nameString“Glass load”Name of a load
loads.palletesObjectAddi­tion­al rules for pal­letes
loads.palletes.is_exchangeableBooleanFalseDeter­mines if type of load is avail­able for exchange at unload­ing place
loads.palletes.is_stackableBooleanFalseSpec­i­fies whether the type of load allows stack­ing
loads.type_of_loadString“europal­lete”Sup­port­ed load type (see dic­tio­nary)
loads.volumeObjectLoad vol­ume
loads.volume.unit_codeString“m3”Unit of load vol­ume. Always is “m3”
loads.volume.valueFloat1.92Val­ue of load vol­ume (range 0.01–10000)
loads.weightObjectLoad weight
loads.weight.maxObjectMin load weight
loads.weight.max.unit_codeString“t”Unit of load weight. Always is “t” (tonnes)
loads.weight.max.valueFloat2Val­ue of load weight (range 0.001 – 100000)
loads.weight.minObjectMax load weight
loads.weight.min.unit_codeString“t”Unit of load weight. Always is “t” (tonnes)
loads.weight.min.valueFloat2.4Val­ue of load weight (range 0.001 – 100000)
loads.widthObjectLoad width
loads.width.unit_codeString“m”Unit of load width. Always is “m” (meters)
loads.width.valueFloat2.1Val­ue of load width (range 0.01–10)
nameString“Route Warsza­wa-Berlin 1”Name of the route
posi­tionInt1Route posi­tion in the list of routes used when match­ing a route to a freight
publication_scenarioObjectDef­i­n­i­tion of pub­li­ca­tion sce­nario for route
publication_scenario.dataObjectObject avail­able only for in_order sce­nario type
publication_scenario.data.orderString“grad­u­al­ly”Order of pub­li­ca­tion to car­ri­er list. Avail­able val­ues:
gradually - after the spec­i­fied pub­li­ca­tion time has elapsed, grad­u­al­ly add next recip­i­ent
next_recipient - after the spec­i­fied pub­li­ca­tion time has elapsed, for­ward­ing to the next recip­i­ent
publication_scenario.data.publication_timeObjectPub­li­ca­tion peri­od for one recip­i­ent
publication_scenario.data.publication_time.unit_codeString“s”Unit time for time val­ue. Always is “s” (sec­onds)
publication_scenario.data.publication_time.user_unit_codeString“min”Unit time indi­cat­ed by user. Avail­able val­ues are “min” (min­utes) or “h” (hours)
publication_scenario.data.publication_time.valueInt300Peri­od of pub­li­ca­tion time in sec­onds.
publication_scenario.typeString“in_order”Pub­li­ca­tion sce­nario type. Avail­able val­ues:
parallel - pub­li­ca­tion to all in par­al­lel
in_order - pub­li­ca­tion in order of the car­ri­er list
require­mentsObjectVehi­cle require­ments
requirements.additional_requirementsArray of StringsAddi­tion­al vehi­cle require­ments (see dic­tio­nary)
requirements.capacityObjectVehi­cle capac­i­ty
requirements.capacity.maxObjectVehi­cle max capac­i­ty
requirements.capacity.max.unit_codeString“t”Unit of max capac­i­ty. Always is “t” (tonnes)
requirements.capacity.max.valueFloat24Val­ue of vehi­cle max capac­i­ty
requirements.capacity.minObjectVehi­cle min capac­i­ty
requirements.capacity.min.unit_codeString“t”Unit of min capac­i­ty. Always is “t” (tonnes)
requirements.capacity.min.valueFloat20Val­ue of vehi­cle min capac­i­ty
requirements.exemption_from_adrBooleanFalseThe load can be trans­port­ed by car­ri­er with­out ADR autho­riza­tion. It occurs only for additional_requirements = adr.
requirements.freight_typeString“FTL”Type of freight. Avail­able val­ues: FTL, LTL, MULTI_FTL, null
requirements.heightObjectVehi­cle height
requirements.height.unit_codeString“m”Unit of vehi­cle height. Always is “m” (meters)
requirements.height.valueFloat2.1Val­ue of vehi­cle height
requirements.lengthObjectVehi­cle length
requirements.length.unit_codeString“m”Unit of vehi­cle length. Always is “m” (meters)
requirements.length.valueFloat3.4Val­ue of vehi­cle length
requirements.required_adr_classesArray of StringsADR freight class­es (see dic­tio­nary)
requirements.required_truck_bodiesArray of StringsExpect­ed vehi­cle body types matched to select­ed vehicle_size (see dic­tio­nary). Array can con­tains max 5 val­ues.
requirements.required_ways_of_loadingArray of StringsThe way of loading/unloading vehi­cle. Accept­able val­ues: back, side, top.
requirements.shipping_remarksString“descrip­tion”Addi­tion­al ship­ping remarks
requirements.vehicle_sizeString“any_size”Expect­ed vehi­cle size (see dic­tio­nary). Default val­ue is any_size. If you select any_size all 4 basic types of vehi­cle size are auto­mat­i­cal­ly select­ed.
requirements.volumeObjectVehi­cle vol­ume
requirements.volume.unit_codeString“m3”Unit of vehi­cle vol­ume. Always is “m3” (cubic meters)
requirements.volume.valueFloat12.1Val­ue of vehi­cle vol­ume
requirements.widthObjectVehi­cle width
requirements.width.unit_codeString“m”Unit of vehi­cle width. Always is “m” (meters)
requirements.width.valueFloat2.3Val­ue of vehi­cle width
shipment_summaryObject
shipment_summary.amountInt
shipment_summary.distanceObject
shipment_summary.distance.unit_codeString“km”
shipment_summary.distance.valueInt
shipment_summary.priceArray of Object
shipment_summary.price.amountInt
shipment_summary.price.currencyString
shipment_summary.weightObject
shipment_summary.weight.unit_codeString“t”
shipment_summary.weight.valueFloat
shipper_idInt1007374Route own­er id
spotsArray of ObjectsCol­lec­tion of routes’ spots. One load­ing and one unload­ing will occur.
spots.idString“21b4c767-8119–4938-8957-aeef320c4b2e”Spot id
spots.nameString“Wrocław home point”Name of spot
spots.placeObjectInfor­ma­tion relat­ed to sin­gle place on route
spots.place.addressObjectAddress of the select­ed point
spots.place.address.countryString“pl”Coun­try using ISO val­ues (see dic­tio­nary)
spots.place.address.detailed_location_idInt123456Detailed loca­tion id
spots.place.address.foreign_idIntnullFor­eign address id
spots.place.address.localityStringWrocławCity name
spots.place.address.location_idInt234567Loca­tion id
spots.place.address.numberString“2–4”Prop­er­ty num­ber
spots.place.address.postal_codeString“51–546”Postal code
spots.place.address.radiusFloatnullRadius
spots.place.address.streetString“Racław­ic­ka”Street name
spots.place.coordinatesObjectLon­gi­tude and lat­i­tude for select­ed point
spots.place.coordinates.latitudeFloat53.35801Lat­i­tude of the point along the route
spots.place.coordinates.longitudeFloat-2.16539Lon­gi­tude of the point along the route
spots.typeString“load­ing”Avail­able val­ues: loading, unloading
sta­tusString“active”Route sta­tus. Avail­able val­ues: active, archival
suggested_calculated_route_idString“46575331–7f0a-4f31-acaf-abc8eb08e72d”
unique_keyString“Route-PL-DE‑1”Route unique name
_statsObjectRoute sta­tis­tics
_stats.contractsObjectRoute con­tract sta­tis­tics
_stats.contracts.acceptedInt1Num­ber of accept­ed con­tracts
_stats.contracts.activeInt1Num­ber of active con­tracts
_stats.contracts.finishedInt1Num­ber of fin­ished con­tracts
_stats.contracts.finished_previously_acceptedInt0Num­ber of fin­ished con­tracts pre­vi­ous­ly accept­ed
_stats.contracts.fixedInt0Num­ber of con­tracts with fixed price
_stats.contracts.flexibleInt0Num­ber of con­tracts with flex­i­ble price
_stats.contracts.refusedInt1Num­ber of refused con­tracts
_stats.contracts.registeredInt0Num­ber of reg­is­tered con­tracts
_stats.contracts.waiting_for_acceptanceInt2Num­ber of con­tracts wait­ing for accep­tance
_stats.contracts.waiting_for_carrier_offerInt1Num­ber of con­tracts wait­ing for car­ri­er offer
_stats.contracts.waiting_for_initial_carrier_offerInt0Num­ber of con­tracts wait­ing for first car­ri­er offer
_stats.contracts.waiting_for_shipper_offerInt1Num­ber of con­tracts wait­ing for ship­per offer
_stats.transportsObjectRoute trans­ports sta­tis­tics
_stats.transports.awaitingObjectRoute trans­ports await­ing for real­iza­tion
_stats.transports.awaiting.countIntNum­ber of await­ing trans­ports
_stats.transports.awaiting.median_priceFloatMedi­an price for trans­ports await­ing for real­iza­tion
_stats.transports.cheapest_carrier_offer
_stats.transports.realizedObjectRoute trans­ports real­ized
_stats.transports.realized.average_priceFloatAver­age price for real­ized trans­ports
_stats.transports.realized.countIntNum­ber of real­ized trans­ports
Response Body
{
    "id": "a367d921-aff7-4952-98d3-cb7a0c9faa0b",
    "unique_key": "API_test1",
    "name": "Route PL-DE 1",
    "publication_scenario": {
        "type": "parallel"
    },
    "spots": [
        {
            "id": "2c67b81d-93f4-4fdb-a147-20e2a65562be",
            "name": "Home base",
            "type": "loading",
            "place": {
                "address": {
                    "locality": "Wrocław",
                    "postal_code": "53-146",
                    "country": "pl",
                    "street": "Racławicka",
                    "number": "2-4",
                    "location_id": 1185465,
                    "detailed_location_id": 58279582,
                    "foreign_id": null,
                    "radius": null
                },
                "coordinates": {
                    "latitude": 51.0825872,
                    "longitude": 17.0038841
                }
            }
        },
        {
            "id": "e836e15c-1d71-4808-b5c8-94abc54d53fe",
            "name": "Collection AB GmbH",
            "type": "unloading",
            "place": {
                "address": {
                    "locality": "Brieselang",
                    "postal_code": "09000",
                    "country": "de",
                    "street": null,
                    "number": null,
                    "location_id": null,
                    "detailed_location_id": null,
                    "foreign_id": null,
                    "radius": null
                },
                "coordinates": {
                    "latitude": 52.58216,
                    "longitude": 12.99756
                }
            }
        }
    ],
    "distance": {
        "declared": {
            "value": 165,
            "unit_code": "km"
        },
        "calculated": {
            "value": 374,
            "unit_code": "km"
        }
    },
    "suggested_calculated_route_id": "89a91340-bac1-4427-87da-82d694118b4e",
    "distance_match": {
        "min": {
            "value": 150,
            "unit_code": "km"
        },
        "max": {
            "value": 190,
            "unit_code": "km"
        }
    },
    "is_roundtrip": false,
    "requirements": {
        "required_truck_bodies": [
            "cooler"
        ],
        "required_adr_classes": [
            "adr_1_1"
        ],
        "required_ways_of_loading": [
            "top"
        ],
        "additional_requirements": [
            "cleaning_certificate",
            "adr"
        ],
        "shipping_remarks": "dodatkowy opis",
        "freight_type": "MULTI_FTL",
        "vehicle_size": "solo",
        "width": {
            "value": 2,
            "unit_code": "m"
        },
        "height": {
            "value": 2,
            "unit_code": "m"
        },
        "length": {
            "value": 5,
            "unit_code": "m"
        },
        "volume": {
            "value": 20,
            "unit_code": "m3"
        },
        "capacity": {
            "min": {
                "value": 12,
                "unit_code": "t"
            },
            "max": {
                "value": 23,
                "unit_code": "t"
            }
        },
        "exemption_from_adr": true
    },
    "loads": [
        {
            "name": null,
            "type_of_load": "20ot_open_top",
            "amount": 2,
            "width": {
                "value": 2.44,
                "unit_code": "m"
            },
            "height": {
                "value": 2.59,
                "unit_code": "m"
            },
            "length": {
                "value": 6.1,
                "unit_code": "m"
            },
            "volume": {
                "value": 38.55,
                "unit_code": "m3"
            },
            "weight": {
                "min": {
                    "value": 5,
                    "unit_code": "t"
                },
                "max": {
                    "value": 7,
                    "unit_code": "t"
                }
            },
            "pallets": {
                "is_stackable": false,
                "is_exchangeable": false
            }
        }
    ],
    "balancing": {
        "type": "freight_limit",
        "allowed_types": [
            "manual",
            "contract_condition",
            "freight_limit",
            "percentage_share",
            "price_ascending"
        ],
        "data": {
            "freight_limit": {
                "min": 10,
                "max": 90
            }
        }
    },
    "status": "active",
    "shipments_summary": {
        "amount": 0,
        "weight": {
            "value": 0,
            "unit_code": "t"
        },
        "distance": {
            "value": 0,
            "unit_code": "km"
        },
        "price": [
            {
                "amount": null,
                "currency": null
            }
        ]
    },
    "position": 235,
    "_stats": {
        "contracts": {
            "fixed": 0,
            "flexible": 0,
            "registered": 2,
            "waiting_for_acceptance": 0,
            "waiting_for_initial_carrier_offer": 0,
            "waiting_for_shipper_offer": 0,
            "waiting_for_carrier_offer": 0,
            "refused": 0,
            "accepted": 1,
            "active": 0,
            "finished": 0,
            "finished_previously_accepted": 0
        },
        "transports": {
            "realized": {
                "average_price": null,
                "count": 0
            },
            "awaiting": {
                "median_price": null,
                "count": null
            },
            "cheapest_carrier_offer": null
        }
    },
    "shipper_id": 1007374,
    "last_modification_date": "2026-04-23T09:07:13+00:00"
}

Client errors (code 400)

HTTP 4xx sta­tus codes indi­cate client errors, mean­ing that the request could not be processed due to an issue on the client side. Below is a list of request-spe­cif­ic errors.

Example error 1

Route does not exists or no access

{
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
    "title": "Not Found",
    "status": 404,
    "detail": "Route with ID: b367d921-aff7-4952-98d3-cb7a0c9faa0b not found!"
}