1. Trans.eu Api
  2. Freights section
  3. Get accepted freight proposals

Get accepted freight proposals

Down­load­ing lists of freight offers accept­ed by employ­ees from your com­pa­ny.

For down­load active freight pro­pos­als vis­it Get freight pro­pos­al list, for down­load archived freights vis­it Get archived freight pro­pos­als.

GET
/ext/freights-api/v1/freight-proposals/accepted
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/freights-api/v1/freight-proposals/accepted 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
contact_employeesArray of ObjectsList of ship­per’s employ­ees assigned to freight nego­ti­a­tion.
contact_employees.last_nameStringNowakSur­name of assigned employ­ee
contact_employees.nameStringJanFirst name of assigned employ­ee
contact_employees.trans_idString13443–1Tran­sId of assigned employ­ee
cre­at­edString“2026–03-25T08:47:54+00:00”Freight cre­ation date (UTC for­mat)
ftlBooleanTrueDeter­mines if freight is a full truck load (True) or less than truck­load (False). See also transport.type below.
heightFloat2Vehi­cle height (range: 0.01–10)
idInt345123Freight iden­ti­fi­ca­tion num­ber (freight-id)
lengthFloat2.1Vehi­cle length (range: 0.01–100)
load­ingObjectInfor­ma­tion relat­ed to first load­ing place on freight’s route
loading.placeObjectLoad­ing place address
loading.place.countryString“de”Coun­try using ISO val­ues (see dic­tio­nary)
loading.place.localityString“Berlin”City name
loading.place.postal_codeString“98340”Postal code
pub­li­ca­tionObjectFreight pub­li­ca­tion infor­ma­tion
publication.auction_idString“35a29b95-9c84-4cbb-8fc6-b84979f212e4”Nego­ta­tion id
publication.end_reasonStringnullAlways is null.
publication.idInt456234Pub­li­ca­tion iden­ti­fi­ca­tion num­ber
publication.is_quick_payBooleanFalseDeter­mines whether the pub­li­ca­tion offer is marked as Quick­Pay
publication.is_recommendedBooleannullAlways is null.
publication.is_sharedBooleannullAlways is null.
publication.offer_idString“b4f4d070-27b7-4c8a-8a85-d976a015b835”Offer id. Val­ue used in nego­ti­a­tions.
publication.priceObjectPub­li­ca­tion price details
publication.price.currencyString“eur”Pub­li­ca­tion price cur­ren­cy. See cur­ren­cy dic­tio­nary.
publication.price.periodObjectPay­ment con­di­tions
publication.price.period.daysInt12Num­ber of days of def­fer. For deferred payment only.
publication.price.period.paymentString“def­fered”Freight pay­ment type: deffered, payment_on_unloading, payment_in_advance
publication.price.valueFloat233Pub­li­ca­tion price val­ue (range: 1 – 9 999 999,99)
publication.publish_dateString“2026–03-25T08:47:56+00:00”Date of freight pub­li­ca­tion.
publication.publish_typeString“exchange”Dep­re­cat­ed. This field is no longer used and will be removed in a future ver­sion.
publication.received_offersStringnullAlways is null.
publication.receiversObjectnullAlways is null.
publication.refresh_fromStringnullAlways is null.
publication.sent_toObjectnullAlways is null.
publication.smart_match_offersBooleannullAlways is null.
publication.statusString“fin­ished”Pub­li­ca­tion sta­tus.
publication.stock_idStringnullDep­re­cat­ed. Always is null val­ue.
reference_numberString“FR/2026/03/25/2N0Z”Freight ref­er­ence num­ber — a unique, auto­mat­i­cal­ly assigned busi­ness iden­ti­fi­er of the freight
shipment_external_idString2023/NWX/1/3Exter­nal iden­ti­fi­ca­tion num­ber
sta­tusString“accept­ed”Pro­pos­al sta­tus.
tem­per­a­tureObjectRequired freight trans­port tem­per­a­ture.
temperature.maxInt-1Min­i­mum tem­per­a­ture
temperature.minInt3Max­i­mum tem­per­a­ture
transit_timeInt460Time expressed in min­utes (pos­i­tive inte­ger) for trans­port, if spec­i­fied.
transport_typeString“ftl”Trans­port type. Pos­si­ble val­ues: ftl, ltl, multi_ftl
truck_bodiesArray of String[“box”,“curtainsider”]Vehi­cle body types set in freight (see dic­tio­nary).
unload­ingObjectInfor­ma­tion relat­ed to last unload­ing place on freight’s route
unloading.placeObjectUnload­ing place address
unloading.place.countryString“pl”Coun­try using ISO val­ues (see dic­tio­nary)
unloading.place.localityString“Wro­claw”City name
unloading.place.postal_codeString50–900Postal code
vehicle_sizeString“lorry_solo”Vehi­cle sizes set in freight. Basic or Com­pos­ite vehi­cle size name accord­ing to dic­tio­nary.
vol­umeFloat3.4Vehi­cle vol­ume (range 0.01–10000).
widthFloat4.2Vehi­cle width (range 0.01–10).
Response Body
[
    {
        "contact_employees": [
            {
                "last_name": "Nowak",
                "name": "Jan",
                "trans_id": "1007374-5"
            }
        ],
        "created": "2026-03-25T08:47:54.000Z",
        "ftl": true,
        "height": 2,
        "id": 3890499,
        "length": 2,
        "loading": {
            "place": {
                "country": "pl",
                "locality": "Rzeszów",
                "postal_code": "35-002"
            }
        },
        "publication": {
            "auction_id": "a526bf4a-304b-4cf1-8847-f591c56f3bee",
            "end_reason": null,
            "id": 3362339,
            "is_quick_pay": false,
            "is_recommended": null,
            "is_shared": null,
            "offer_id": "b9684303-eb40-4574-9a20-e9c076ebb545",
            "price": {
                "currency": "pln",
                "period": {
                    "days": 11,
                    "payment": "deferred"
                },
                "value": 156
            },
            "publish_date": "2026-03-25T08:47:54.000Z",
            "publish_type": "exchange",
            "received_offers": null,
            "receivers": null,
            "refresh_from": null,
            "sent_offers": null,
            "sent_to": null,
            "smart_match_offers": null,
            "status": "finished",
            "stock_id": null
        },
        "reference_number": "FR/2026/03/25/2N0Z",
        "shipment_external_id": null,
        "status": "accepted",
        "temperature": {
            "max": 9,
            "min": 6
        },
        "transit_time": null,
        "transport_type": "ftl",
        "truck_bodies": [
            "cooler"
        ],
        "unloading": {
            "place": {
                "country": "it",
                "locality": "Mediolan",
                "postal_code": "20097"
            }
        },
        "vehicle_size": "solo",
        "volume": 12,
        "width": 3
    }
]

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.