Creating new freight at Trans.eu Platform and sending it to Freight multi exchange.
Url parameters and connection settings
- URL: https://api.platform.trans.eu
- Endpoint: /ext/freights-api/v2/freights
- Method: POST
Headers:
- Content-type: application/json
- Accept: application/json
- Authorization: Bearer {access_token}
- Api-key: {unique_app_api_key}
Authorization
Authorization process is described here.
| Json | Example | Type | Is required | Description |
| capacity | 12 | Float | Yes | Total freight capacity in tonnes. This value is being validated in comparison to the sum of all loads weight. Range: 0,001 – 100000 |
| publish | True | Boolean | Yes | Determines if the freight is automatically published or only created |
| payment | Object | No | Payment conditions for publication using groups or smart match | |
| requirements | Object | Yes | Main freight requirements, including truck body and size adr classes, ways of loading | |
| loads | Array | No | Collection of freights’ loads. It is possible to send empty array of loads, nevertheless an array has to be set | |
| spots | Object | Yes | Collection of freights’ spots – at least one loading and one unloading is required | |
| receivers | Object | Yes | Specifies the list of exchanges on which the offer is published. Multiple types of exchanges can be specified at the same time. |
Example request
Sample Json for creating new freight using required data only
{
"capacity": 12,
"requirements": {
"is_ftl": true,
"required_truck_bodies": [
"dump-truck"
],
"vehicle_size": "lorry"
},
"loads": [],
"spots": [
{
"spot_order": 1,
"place": {
"address": {
"country": "pl",
"street": "Racławicka",
"locality": "Wrocław",
"postal_code": "53-146"
}
},
"operations": [
{
"type": "loading",
"operation_order": 1,
"timespans": {
"end": "2025-07-04T13:00:00+0100",
"begin": "2025-07-04T12:00:00+0100"
}
}
]
},
{
"spot_order": 2,
"place": {
"address": {
"country": "de",
"street": "Aktienstraße 177",
"locality": "Essen",
"postal_code": "45359"
}
},
"operations": [
{
"type": "unloading",
"operation_order": 1,
"timespans": {
"end": "2025-07-05T13:00:00+0100",
"begin": "2025-07-05T12:00:00+0100"
}
}
]
}
],
"receivers": {
"corporate_exchanges": ["b3a7b0f0-d7f4-4de8-aa6d-61b5d9bae999"],
"private_exchanges": ["051d6148-903a-4735-bc57-feebfdd8c900"],
"public_exchange": true
}
}Response
{
"accepted_price": null,
"capacity": 12,
"carrier": null,
"contact_employees": [
{
"last_name": "Testowy",
"name": "Jan",
"trans_id": "1111111-1"
}
],
"distance": null,
"end_reason": null,
"id": 3247659,
"is_first_buy": null,
"loads": [],
"publication_price": null,
"publication_status": null,
"receivers": {
"corporate_exchanges": [
{
"id": "b3a7b0f0-d7f4-4de8-aa6d-61b5d9bae999",
"name": "API"
}
],
"private_exchanges": [
{
"id": "051d6148-903a-4735-bc57-feebfdd8c900",
"name": "Private"
}
]
},
"reference_number": "FR/2025/07/04/2N13",
"requirements": {
"exemption_from_adr": false,
"is_ftl": true,
"is_mini_tenders": false,
"monitoring": "required",
"other_requirements": [],
"required_adr_classes": [],
"required_door_types": [],
"required_tipper_trailer_additional_equipment": [],
"required_truck_bodies": [
"dump-truck"
],
"required_ways_of_loading": [],
"shipping_remarks": null,
"temperature": {
"max": null,
"min": null
},
"transport": {
"count": null,
"schedule_type": null,
"settlement": "route",
"settlement_basis": null,
"total_weight": null,
"type": "ftl",
"units_per_transport": null
},
"vehicle_size_id": "lorry"
},
"sent_to": {
"corporate_exchange": true,
"private_exchange": true,
"public_exchange": true
},
"shipment_external_id": null,
"spots": [
{
"description": null,
"name": null,
"operations": [
{
"id": 7492124,
"loads": [],
"operation_order": 1,
"operation_time": null,
"timespans": {
"begin": "2025-07-04T13:00:00+02:00",
"begin_local": "2025-07-04T13:00:00+02:00",
"end": "2025-07-04T14:00:00+02:00",
"end_local": "2025-07-04T14:00:00+02:00",
"timezone": "Europe/Warsaw"
},
"type": "loading"
}
],
"place": {
"address": {
"country": "pl",
"description": null,
"detailed_location_id": null,
"foreign_id": null,
"id": 7333952,
"locality": "Wrocław",
"location_id": null,
"number": null,
"postal_code": "53-146",
"radius": null,
"street": "Racławicka"
},
"coordinates": {
"latitude": 51.079202595,
"longitude": 16.993128942
},
"range_distance": null
},
"spot_order": 1
},
{
"description": null,
"name": null,
"operations": [
{
"id": 7492125,
"loads": [],
"operation_order": 1,
"operation_time": null,
"timespans": {
"begin": "2025-07-05T13:00:00+02:00",
"begin_local": "2025-07-05T13:00:00+02:00",
"end": "2025-07-05T14:00:00+02:00",
"end_local": "2025-07-05T14:00:00+02:00",
"timezone": "Europe/Berlin"
},
"type": "unloading"
}
],
"place": {
"address": {
"country": "de",
"description": null,
"detailed_location_id": null,
"foreign_id": null,
"id": 7333953,
"locality": "Essen",
"location_id": null,
"number": null,
"postal_code": "45359",
"radius": null,
"street": "Aktienstraße 177"
},
"coordinates": {
"latitude": 51.46695325,
"longitude": 6.921194574
},
"range_distance": null
},
"spot_order": 2
}
],
"status": "waiting_for_publication",
"surcharges": [],
"transit_time": null
}