Downloading lists of freight offers published directly to you or to your company (publication to partners or by fixed route).
These offers are visible in the ‘For me’ tab in the Search loads module.
For download accepted freight proposals visit Get accepted freight proposals, for download archived freights visit Get archived freight proposals.
GET
/ext/freights-api/v2/freight-proposals
This method supports query modifiers that allow you to customize the list of returned results to your own needs. The list of all parameters is specified below in Query Parameters.
- Sorting — allows you to arrange the results in the specified order
- Pagination — allows you to download results from a specific list page
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.
Successful Response
Error Response
Request Header
GET /ext/freights-api/v2/freight-proposals 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}Request Parameters (Query)
Sorting
The results will be arranged in the specified order.
| Sorted freight field | Filter example |
| loading date | /ext/freights-api/v2/ |
| unloading date | /ext/freights-api/v2/ |
You can sorting in ascending or descending mode by adding order parameter with value asc or desc. Example:
/ext/freights-api/v2/freight-proposals?sortBy=loading_date&order=descPagination
The results will be downloaded from a specific list page. Each page contains maximum of 30 results.
/ext/freights-api/v2/freight-proposals?page=2Response Fields
| Attribute | Type | Example | Description |
| contact_employees | Array of Objects | List of employees assigned to freight negotiation. The list is empty after negotiations start (see employee_id field) | |
| 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 |
| created_at | String | “2026–03-25T08:47:54+00:00” | Freight creation date (UTC format) |
| decision_date | String | “2026–03-26T20:30:00+01:00” | Time up to which carriers can send offers |
| freight | Object | Freight parameters | |
| freight.capacity | Object | Total freight capacity. | |
| freight.capacity.unit_code | String | “t” | Unit of weight freight capacity. Always is “t” (tonnes). |
| freight.capacity.value | Float | 12 | Value of freight capacity. |
| distance | Int | 345000 | Distance in meters from the point of loading to the point of unloading. |
| id | Int | 345123 | Freight identification number (freight-id) |
| loading_meters | Object | Total freight loading meters (range: 0,01 — 417) | |
| loading_meters.unit_code | String | “ldm” | Unit of loading meters. Always is “ldm”. |
| loading_meters.value | Float | 3.6 | Value of loading meters. |
| publication | Object | Freight publication information | |
| publication.id | Int | 456234 | Publication identification number |
| publication.is_quick_pay | Boolean | False | Determines whether the publication offer is marked as QuickPay |
| publication.period | Object | Payment conditions | |
| publication.period.days | Int | 12 | Number of days of deffer. For deferred payment only. |
| publication.period.payment | String | “deffered” | Freight payment type: deffered, payment_on_unloading, payment_in_advance |
| publication.price | Object | Publication price details | |
| publication.price.currency | String | “eur” | Publication price currency. See currency dictionary. |
| publication.price.value | Float | 233 | Publication price value (range: 1 – 9 999 999,99) |
| publication.price_type | String | “route” | Type of settlement. Default is route. For multifreights available values: route, ton. |
| publication.publish_type | String | “exchange” | Deprecated. This field is no longer used and will be removed in a future version. |
| publication.total_price | Object | Publication price details | |
| publication.total_price.currency | String | “eur” | Publication price currency. See currency dictionary. |
| publication.total_price.value | Float | 233 | Publication price value (range: 1 – 9 999 999,99) |
| requirements (see details) | Object | Main freight requirements. Vehicle_size is called vehicle_size_id. | |
| shipment_external_id | String | 2023/NWX/1/3 | External identification number |
| shipper | Object | Publishing company details | |
| shipper.address | Object | Publishing company address | |
| shipper.address.country | String | “PL” | Country using ISO values (see dictionary) |
| shipper.address.locality | String | Katowice | City Name |
| shipper.address.postal_code | String | 33–450 | Postal code |
| shipper.address.street | String | Slaska | Street name |
| shipper.bonabanco | Object | contractor’s designation in Bonabanco | |
| shipper.bonabanco.carrier | Boolean | False | designation as carrier |
| shipper.bonabanco.forwarder | Boolean | True | designation as forwarder |
| shipper.company_id | Int | 234123 | Office Id shipper company |
| shipper.email | String | smix@example.com | Email address |
| shipper.fax_number | String | “0048 234567567” | Fax number |
| shipper.id | Int | 3980 | Deprecated field. |
| shipper.legal_name | String | Sales Exp | Company name |
| shipper.telephone | String | “0048 234567367” | Phone number |
| shipper.vat_id | String | PL234564534 | Legal (tax) company identifier |
| spots (see details) | Array of Objects | Collection of freights’ spots. At least one loading and one unloading will occur. This response contains more fields than listed in spots details, additional fields are listed below. | |
| spots.id | Int | 8758130 | Spot id |
| spots.operations.id | Int | 8792861 | Spot operation id |
| spots.operations.loads | Array of Objects | Collection of freight loads to be reloaded at this spot point. See details in the table below. | |
| spots.place.address.detailed_location_id | Int | 1013456342 | Detailed location id |
| spots.place.address.foreign_id | Int | null | Always null. |
| spots.place.address.id | Int | 7873453 | Address id |
| spots.place.address.location_id | Int | 2374932 | Location id |
| spots.place.address.radius | Int | 200 | |
| freight_publication_id | Int | 3345643 | Publication freight id |
| id | String | “b4f4d070-27b7-4c8a-8a85-d976a015b835” | Offer id |
| is_first_buy | Boolean | False | Defines if price will be negotiated or only accepted by carrier. |
| is_first_buy_with_confirmation | Boolean | null | Negotiation option for contracts. |
| is_quick_pay | Boolean | null | Determines whether the publication offer is marked as QuickPay |
| price | Object | Proposal price details | |
| price.currency | String | “eur” | Proposal price currency. See currency dictionary. |
| price.value | Float | 167 | Current negotiation price value (range: 1 – 9 999 999,99) |
| price_type | String | “route” | Type of settlement. Default is route. For multifreights available values: route, ton. |
| publish_date | String | “2026–03-25T08:47:56+00:00” | Date of freight publication. |
| status | String | “active” | Proposal status. |
| updated_at | String | “2026–03-25T09:47:55+01:00” | Date of the last update in freight proposal. |
Response Body
[
// Proposal no. 1
{
"contact_employees": [
{
"last_name": "Nowak",
"name": "Jan",
"trans_id": "1007374-5"
}
],
"created_at": "2026-03-25T13:51:06+00:00",
"decision_date": "2026-03-26T08:00:00+01:00",
"freight": {
"capacity": {
"unit_code": "t",
"value": 24
},
"distance": 1219000,
"id": 3891981,
"loading_meters": null,
"publication": {
"id": 3363715,
"is_quick_pay": false,
"period": {
"days": 11,
"payment": "deferred"
},
"price": {
"currency": "eur",
"value": 650
},
"price_type": "route",
"publish_type": "exchange",
"total_price": {
"currency": "eur",
"value": 650
}
},
"requirements": {
"is_ftl": true,
"monitoring": "required",
"other_requirements": [],
"required_adr_classes": [],
"required_truck_bodies": [
"curtainsider"
],
"required_ways_of_loading": [
"side"
],
"shipping_remarks": null,
"transport": {
"proposed_count": null,
"schedule_type": "together",
"settlement": "route",
"settlement_basis": null,
"type": "ftl"
},
"vehicle_size_id": "solo"
},
"shipment_external_id": null,
"shipper": {
"address": {
"country": "PL",
"locality": "Szczecin",
"postal_code": "98-825",
"street": "Radosna 27"
},
"bonabanco": {
"forwarder": true
},
"company_id": 1007374,
"email": "soffice@tranexp.eu",
"fax_number": "0048 395561680",
"id": 1007374,
"legal_name": "Tran Export",
"telephone": "(0048) 424743503",
"vat_id": "PL8370257415"
},
"spots": [
{
"id": 8761111,
"operations": [
{
"id": 8795842,
"loads": [],
"operation_order": 1,
"timespans": {
"begin": "2026-03-25T15:00:00+01:00",
"begin_local": "2026-03-25T15:00:00+01:00",
"end": "2026-03-25T15:00:00+01:00",
"end_local": "2026-03-25T15:00:00+01:00",
"timezone": "Europe/San_Marino"
},
"type": "loading"
}
],
"place": {
"address": {
"country": "it",
"detailed_location_id": null,
"foreign_id": null,
"id": 8636589,
"locality": "Mediolan",
"location_id": 65505581,
"number": null,
"postal_code": "20097",
"radius": 2176,
"street": null
},
"coordinates": {
"latitude": 45.397205283,
"longitude": 9.21659417
}
},
"spot_order": 1
},
{
"id": 8761112,
"operations": [
{
"id": 8795843,
"loads": [],
"operation_order": 1,
"timespans": {
"begin": "2026-03-26T08:00:00+01:00",
"begin_local": "2026-03-26T08:00:00+01:00",
"end": "2026-03-26T08:00:00+01:00",
"end_local": "2026-03-26T08:00:00+01:00",
"timezone": "Europe/Warsaw"
},
"type": "unloading"
}
],
"place": {
"address": {
"country": "pl",
"detailed_location_id": null,
"foreign_id": null,
"id": 8636590,
"locality": "Szczecin",
"location_id": 29553042,
"number": null,
"postal_code": "70-001",
"radius": 1391,
"street": null
},
"coordinates": {
"latitude": 53.389142217,
"longitude": 14.514850097
}
},
"spot_order": 2
}
]
},
"freight_publication_id": 3363715,
"id": "f9ba62c5-c252-49e9-96f0-6360384a13d8",
"is_first_buy": false,
"is_first_buy_with_confirmation": null,
"is_quick_pay": false,
"price": {
"currency": "eur",
"value": 650
},
"price_type": "route",
"publish_date": "2026-03-25T13:51:08+00:00",
"status": "active",
"updated_at": "2026-03-25T14:51:45+01:00"
},
// Proposal no. 2 - multi_ftl with loads
{
"contact_employees": [
{
"last_name": "Nowak",
"name": "Jan",
"trans_id": "1007374-5"
}
],
"created_at": "2026-03-25T11:29:41+00:00",
"decision_date": "2026-03-26T08:00:00+01:00",
"freight": {
"capacity": {
"unit_code": "t",
"value": 12
},
"distance": 0,
"id": 3890892,
"loading_meters": {
"unit_code": "ldm",
"value": 0.4
},
"publication": {
"id": 3362728,
"is_quick_pay": false,
"period": {
"days": 11,
"payment": "deferred"
},
"price": {
"currency": "pln",
"value": 145
},
"price_type": "3_km",
"publish_type": "exchange",
"total_price": {
"currency": "pln",
"value": 145
}
},
"requirements": {
"is_ftl": false,
"monitoring": "required",
"other_requirements": [],
"required_adr_classes": [],
"required_truck_bodies": [
"cooler"
],
"required_ways_of_loading": [],
"shipping_remarks": null,
"transport": {
"per_order_max": 4,
"per_order_min": 1,
"proposed_count": null,
"schedule_type": "together",
"settlement": "3_km",
"settlement_basis": "5_distance_declared_by_carrier",
"type": "multi_ftl"
},
"vehicle_size_id": "solo"
},
"shipment_external_id": null,
"shipper": {
"address": {
"country": "PL",
"locality": "Szczecin",
"postal_code": "98-825",
"street": "Radosna 27"
},
"bonabanco": {
"forwarder": true
},
"company_id": 1007374,
"email": "soffice@tranexp.eu",
"fax_number": "0048 395561680",
"id": 1007374,
"legal_name": "Tran Export",
"telephone": "(0048) 424743503",
"vat_id": "PL8370257415"
},
"spots": [
{
"id": 8758918,
"operations": [
{
"id": 8793649,
"loads": [
{
"load": {
"amount": 1,
"cleaning_regime": null,
"height": {
"unit_code": "m",
"value": 2
},
"id": 3823900,
"idtf": null,
"is_exchangeable": false,
"is_stackable": false,
"length": {
"unit_code": "m",
"value": 1.2
},
"load_id": "3823900",
"name": "Ładunek 1",
"type_of_load": "2_europalette",
"volume": {
"unit_code": "m3",
"value": 1.92
},
"weight": {
"unit_code": "t",
"value": 3
},
"width": {
"unit_code": "m",
"value": 0.8
}
},
"weight": {
"unit_code": "t",
"value": 3
}
}
],
"operation_order": 1,
"timespans": {
"begin": "2026-03-25T13:00:00+01:00",
"begin_local": "2026-03-25T13:00:00+01:00",
"end": "2026-03-25T13:00:00+01:00",
"end_local": "2026-03-25T13:00:00+01:00",
"timezone": "Europe/Warsaw"
},
"type": "loading"
}
],
"place": {
"address": {
"country": "pl",
"detailed_location_id": 101138203,
"foreign_id": null,
"id": 8634395,
"locality": "Wrocław",
"location_id": 1547725,
"number": "10",
"postal_code": "50-001",
"radius": 200,
"street": "Gwarna"
},
"coordinates": {
"latitude": 51.100417679,
"longitude": 17.038294432
}
},
"spot_order": 1
},
{
"id": 8758919,
"operations": [
{
"id": 8793650,
"loads": [
{
"load": {
"amount": 1,
"cleaning_regime": null,
"height": {
"unit_code": "m",
"value": 2
},
"id": 3823900,
"idtf": null,
"is_exchangeable": false,
"is_stackable": false,
"length": {
"unit_code": "m",
"value": 1.2
},
"load_id": "3823900",
"name": "Ładunek 1",
"type_of_load": "2_europalette",
"volume": {
"unit_code": "m3",
"value": 1.92
},
"weight": {
"unit_code": "t",
"value": 3
},
"width": {
"unit_code": "m",
"value": 0.8
}
},
"weight": {
"unit_code": "t",
"value": 3
}
}
],
"operation_order": 1,
"timespans": {
"begin": "2026-03-26T08:00:00+01:00",
"begin_local": null,
"end": "2026-03-26T08:00:00+01:00",
"end_local": null,
"timezone": null
},
"type": "unloading"
}
],
"place": {
"address": {
"country": "pl",
"detailed_location_id": null,
"foreign_id": null,
"id": 8634396,
"locality": "Wrocław",
"location_id": 2513724,
"number": "2",
"postal_code": "50-002",
"radius": null,
"street": "Nowa"
},
"coordinates": {
"latitude": 51.1,
"longitude": 17.03333
}
},
"spot_order": 2
}
]
},
"freight_publication_id": 3362728,
"id": "b4f4d070-27b7-4c8a-8a85-d976a015b835",
"is_first_buy": false,
"is_first_buy_with_confirmation": null,
"is_quick_pay": false,
"price": {
"currency": "pln",
"value": 145
},
"price_type": "3_km",
"publish_date": "2026-03-25T16:53:49+00:00",
"status": "active",
"updated_at": "2026-03-25T17:53:48+01:00"
}
]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.