Download details of freight in each status.
The freight-id identification number in request can be taken from response after publishing or creating the freight or by downloading the freight list.
Freight details are available for freights created in your company and for freights published:
GET
/ext/freights-api/v1/freights/{freight-id}
- on freight exchanges (public or private) to which you have access
- to your company
- directly to you
It is allowed for freights created via the API, as well as freights created on the Platform.
Request Authorization
Every request MUST include a valid access token obtained during the user authorization process, provided using the Bearer token scheme in the Authorization header.
Request
Successful Response
Error Response
Request Header
GET /ext/freights-api/v1/freights/{freight-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
| Attribute | Type | Example | Description |
| accepted_price | Object | Final price for freight accepted during publication and negotiation process. Null value in other freight statuses than “accepted”. | |
| accepted_price.currency | String | “eur” | Currency of accepted price |
| accepted_price.value | Float | 332 | Value of accepted price |
| archived_at | String | “2026–01-29T15:15:26+01:00” | Date of freight acceptance or freight archivization. It does not occur in other freight statuses than “accepted” or “finished”. |
| capacity | Float | 22.1 | Total freight capacity in tonnes. |
| carrier (see details) | Object | Carrier selected during negotiation process. Null value in other freight statuses than “accepted”. | |
| contact_employees | Array of Objects | List of employees assigned to freight negotiation. Default is publisher. | |
| contact_employees.last_name | String | Nowak | Surname of assigned employee |
| contact_employees.name | String | Jan | First name of assigned employee |
| contact_employees.trans_id | String | 13443–1 | TransId of assigned employee |
| distance | Int | 348000 | Distance in meters from the point of loading to the point of unloading. |
| end_reason | String | null | Publication end reason. |
| height | Float | 3.1 | Vehicle height (range: 0.01–10) |
| id | Int | 234923 | Freight identification number, assigned automatically during creation of a new freight. |
| is_first_buy | Boolean | False | Defines if price will be negotiated or only accepted by carrier. |
| length | Float | 12 | Vehicle length (range: 0.01–100) |
| loading_meters | Float | 23 | Total freight loading meters (range: 0,01 — 417) |
| loads (see details) | Array of Objects | Collection of freight loads. | |
| publication_price | Object | Publication price information | |
| publication_price.currency | String | eur | Publication price currency. See currency dictionary. |
| publication_price.value | Int | 560 | Publication price value. Null if the value was not specified. |
| publication_receivers | Array of String | [“567233–1”] | Transid recipients in direct publication |
| publication_status | String | active | Status of the publication. See details in Freight publication. |
| reference_number | String | FR/2025/12/30/2NNQ | Freight reference number — a unique, automatically assigned business identifier of the freight |
| requirements (see details) | Object | Main freight requirements | |
| shipment_external_id | String | 2023/NWX/1/3 | External identification number |
| spots (see details) | Array of Objects | Collection of freights’ spots. At least one loading and one unloading will occur. | |
| status | String | new | Freight status. See details in Freight creation. |
| surchages | Object | null | Surchages for fixed routes. |
| transit_time | Int | 460 | Time expressed in minutes (positive integer) for transport, if specified. |
| volume | Float | 21 | Vehicle volume (range 0.01–10000). |
| width | Float | 3.1 | Vehicle width (range 0.01–10). |
Response Body
{
"accepted_price": null,
"capacity": 12,
"carrier": null,
"contact_employees": [
{
"last_name": "Nowak",
"name": "Jerzy",
"trans_id": "1017374-3"
},
{
"last_name": "Kowalski",
"name": "Marek",
"trans_id": "1017374-4"
}
],
"distance": 348000,
"end_reason": null,
"height": null,
"id": 3829371,
"is_first_buy": false,
"length": null,
"loading_meters": null,
"loads": [
{
"amount": null,
"description": "",
"height": null,
"id": 3765320,
"is_exchangeable": false,
"is_stackable": true,
"length": 1.13,
"load_id": "3765320",
"name": "Frozen meat",
"type_of_load": "container_palette",
"volume": null,
"weight": null,
"width": 1.13
}
],
"publication_price": {
"currency": "pln",
"value": 1200
},
"publication_status": "active",
"reference_number": "FR/2026/02/20/220R",
"requirements": {
"exemption_from_adr": false,
"is_ftl": true,
"monitoring": "without_monitoring",
"other_requirements": [
"temperature_log",
"thermometer"
],
"required_adr_classes": [],
"required_door_types": [],
"required_tipper_trailer_additional_equipment": [],
"required_truck_bodies": [
"isotherm"
],
"required_ways_of_loading": [
"side"
],
"shipping_remarks": null,
"temperature": {
"max": 8,
"min": 3
},
"transport": {
"count": null,
"per_order_max": null,
"per_order_min": null,
"proposed_count": null,
"schedule_type": "together",
"settlement": "route",
"settlement_basis": null,
"total_weight": null,
"type": "ftl"
},
"vehicle_size": "lorry"
},
"shipment_external_id": null,
"spots": [
{
"description": "",
"name": null,
"operations": [
{
"loads": [
{
"load_id": "3765320",
"weight": null
}
],
"operation_order": 1,
"operation_time": null,
"timespans": {
"begin": "2026-02-20T15:00:00+01:00",
"begin_local": "2026-02-20T15:00:00+01:00",
"end": "2026-02-20T20:00:00+01:00",
"end_local": "2026-02-20T20:00:00+01:00",
"timezone": "Europe/Warsaw"
},
"type": "loading"
}
],
"place": {
"address": {
"country": "pl",
"description": null,
"locality": "Wrocław",
"number": "2-4",
"postal_code": "53-146",
"street": "Racławicka"
},
"coordinates": {
"latitude": 51.0825872,
"longitude": 17.0038841
}
},
"spot_order": 1
},
{
"description": "",
"name": "Magazine 2",
"operations": [
{
"loads": [
{
"load_id": "3765320",
"weight": null
}
],
"operation_order": 1,
"operation_time": null,
"timespans": {
"begin": "2026-02-21T08:00:00+01:00",
"begin_local": null,
"end": "2026-02-22T08:00:00+01:00",
"end_local": null,
"timezone": null
},
"type": "unloading"
}
],
"place": {
"address": {
"country": "de",
"description": null,
"locality": "Berlin",
"number": "1",
"postal_code": "10178",
"street": "Magazinstraße"
},
"coordinates": {
"latitude": 52.52437,
"longitude": 13.41053
}
},
"spot_order": 2
}
],
"status": "in_progress",
"surcharges": [],
"transit_time": null,
"volume": null,
"width": null
}Client errors (code 400)
HTTP 4xx status codes indicate client errors, meaning that the request could not be processed due to an issue on the client side. Below is a list of request-specific errors.
Example error 1
Freight does not exists or no access
{
"detail": "Page not found.",
"status": 404,
"title": "Not Found",
"type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}Example error 2
Ongoing direct publication by another employee from your company
{
"detail": "Access to freight forbidden (freight: 3829678, employee: 749989)",
"status": 403,
"title": "Forbidden",
"type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}