1. Trans.eu Api
  2. Freights section
  3. Get freight offer list

Get freight offer list

Down­load list of price offers for select­ed freight with active pub­li­ca­tion.

After suc­cess­ful freight pub­li­ca­tion dur­ing the sub­mis­sion of offers by car­ri­ers, there will be a list of pric­ing offers received from all par­tic­i­pants.
With­drawed offers or offers which expi­ra­tion date has passed will dis­ap­pear from the list.

The freight-id iden­ti­fi­ca­tion num­ber in request can be tak­en from response after pub­lish­ing or cre­at­ing the freight or by down­load­ing the freight list.

GET
/ext/freights-api/v1/freights/{freight-id}/offers
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/freights/{freight-id}/offers 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
carrier_offer_expiration_dateString“2026–01-29T16:15:26+01:00”Time of car­ri­er offer expi­ra­tion.
company_idInt1002345ID of the com­pa­ny that sub­mit­ted the price offer
created_atString“2026–01-29T15:15:26+01:00”Date of cre­at­ing the offer.
freight_idInt3459823Id of freight for which the offers are sub­mit­ted
idGUID4a2dbtsd-bd6b-4c24-6t2c-256af1005591Offer ID (impor­tant for nego­ti­a­tion process)
legal_nameString“Trans­port car­ri­er logisitic”Name of the com­pa­ny that sub­mit­ted the price offer
offer_expiration_dateString“2026–01-30T10:15:26+01:00”Time to sub­mit offers
priceObjectPric­ing con­di­tions
price.currencyStringeurOffer price cur­ren­cy. See cur­ren­cy dic­tio­nary.
price.last_price_authorString1002345–1Sub­mit­ter of cur­rent offer
price.typeStringrouteType of set­tle­ment. Default is route. For mul­ti­freights avail­able val­ues: route, ton.
price.valueFloat450Offer price val­ue (per haulage)
require­mentsStringnullAddi­tion­al requirements/arrangements send by car­ri­er, Dep­re­cat­ed field, val­ue always is null.
sta­tusStringnego­ti­a­tionOffer sta­tus.
trans_idString1002345–2Tran­sId of the employ­ee of the com­pa­ny who sub­mit­ted the price offer
trans­portsObjectOffer details. Avail­able for mul­ti­freights.
transports.countInt2Num­ber of haulages offered by car­ri­er
vat_idStringPL234564534Legal (tax) com­pa­ny iden­ti­fi­er
ver­sionString2Ver­sion num­ber required for reply­ing to the offer (impor­tant for nego­ti­a­tion process)
Response Body
[
    {
        "carrier_offer_expiration_date": null,
        "company_id": 567347,
        "created_at": "2026-03-03T12:21:58.203Z",
        "freight_id": 3828332,
        "id": "3bf52d1c-74e5-4884-b60b-2a21f7cb2607",
        "legal_name": "Carrier Transports",
        "offer_expiration_date": "2026-03-03T22:37:00.000Z",
        "price": {
            "currency": "pln",
            "last_price_author": "567347-2",
            "type": "ton",
            "value": 890
        },
        "requirements": null,
        "status": "negotiation",
        "trans_id": "567347-2",
        "transports": {
            "count": 2
        },
        "vat_id": "PL1234565",
        "version": 2
    },
    {
        "carrier_offer_expiration_date": null,
        "company_id": 567349,
        "created_at": "2026-03-03T12:17:43.599Z",
        "freight_id": 3828332,
        "id": "0918e084-3d40-4bd0-8d1c-c20e7109cdb8",
        "legal_name": "Spedex GmbH",
        "offer_expiration_date": "2026-03-03T22:37:00.000Z",
        "price": {
            "currency": "eur",
            "last_price_author": "1002345-1",
            "type": "ton",
            "value": 120
        },
        "requirements": null,
        "status": "negotiation",
        "trans_id": "567349-1",
        "transports": {
            "count": 2
        },
        "vat_id": "DE7775898640",
        "version": 3
    }
]
Example response body

No offers for freight
or
you are not the con­tact per­son for this freight

[]

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

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

Incor­rect sta­tus of freight

{
    "message": "Freight is not published"
}
Example error 3

No offers for freight

{
    "detail": "Offer read model not found",
    "status": 404,
    "title": "Not Found",
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}