{"id":6310,"date":"2026-03-17T11:02:16","date_gmt":"2026-03-17T10:02:16","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=6310"},"modified":"2026-03-17T11:02:18","modified_gmt":"2026-03-17T10:02:18","slug":"get-freight-offer-list","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/get-freight-offer-list\/","title":{"rendered":"Get freight offer list"},"content":{"rendered":"\n
\n
\n

Down\u00adload list of price offers for select\u00aded freight with active pub\u00adli\u00adca\u00adtion.<\/p>\n\n\n\n\n\n\n\n

After suc\u00adcess\u00adful freight pub\u00adli\u00adca\u00adtion dur\u00ading the sub\u00admis\u00adsion of offers by car\u00adri\u00aders, there will be a list of pric\u00ading offers received from all par\u00adtic\u00adi\u00adpants.
With\u00addrawed offers or offers which expi\u00adra\u00adtion date has passed will dis\u00adap\u00adpear from the list.<\/p>\n\n\n\n

The freight-id<\/code> iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber in request can be tak\u00aden from response after pub\u00adlish\u00ading or cre\u00adat\u00ading the freight or by down\u00adload\u00ading the freight list.<\/p>\n<\/div>\n\n\n\n

\n
GET<\/strong>
\/ext\/freights-api\/v1\/freights\/{freight-id}\/offers<\/pre>\n<\/div>\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
\n
\n
 Request Authorization<\/h6>\n<\/div>\n\n\n\n
\n
Every request MUST include a valid access token obtained dur\u00ading the user autho\u00adriza\u00adtion process<\/a>, pro\u00advid\u00aded using the Bear\u00ader token scheme in the Autho\u00adriza\u00adtion head\u00ader.<\/p>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
 Request<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Request Head\u00ader<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
 Successful Response<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Response Fields<\/a><\/p>\n<\/div>\n\n\n\n
\n
Response Body<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
 Error Response<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Client errors (400)<\/a><\/p>\n<\/div>\n\n\n\n
\n
Gen\u00ader\u00adal API errors<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Request Header<\/h6>\n<\/div>\n\n\n\n
\n
GET \/ext\/freights-api\/v1\/freights\/{freight-id}\/offers HTTP\/1.1 \nHost: api.platform.trans.eu \nContent-Type: application\/json\nAccept: application\/json\nAuthorization: Bearer {access_token) \nApi-key: {unique_app_api-key}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
Response Fields<\/h6>\n\n\n\n
Attribute<\/td>Type<\/td>Exam\u00adple<\/td>Descrip\u00adtion<\/td><\/tr>
carrier_offer_expiration_date<\/td>String<\/td>\u201c2026\u201301-29T16:15:26+01:00\u201d<\/td>Time of car\u00adri\u00ader offer expi\u00adra\u00adtion.<\/td><\/tr>
company_id<\/td>Int<\/td>1002345<\/td>ID of the com\u00adpa\u00adny that sub\u00admit\u00adted the price offer<\/td><\/tr>
created_at<\/td>String<\/td>\u201c2026\u201301-29T15:15:26+01:00\u201d<\/td>Date of cre\u00adat\u00ading the offer.<\/td><\/tr>
freight_id<\/td>Int<\/td>3459823<\/td>Id of freight for which the offers are sub\u00admit\u00adted<\/td><\/tr>
id<\/td>GUID<\/td>4a2dbtsd-bd6b-4c24-6t2c-256af1005591<\/td>Offer ID (impor\u00adtant for nego\u00adti\u00ada\u00adtion process)<\/td><\/tr>
legal_name<\/td>String<\/td>\u201cTrans\u00adport car\u00adri\u00ader logisitic\u201d<\/td>Name of the com\u00adpa\u00adny that sub\u00admit\u00adted the price offer<\/td><\/tr>
offer_expiration_date<\/td>String<\/td>\u201c2026\u201301-30T10:15:26+01:00\u201d<\/td>Time to sub\u00admit offers<\/td><\/tr>
price<\/td>Object<\/td><\/td>Pric\u00ading con\u00addi\u00adtions<\/td><\/tr>
price.currency<\/td>String<\/td>eur<\/td>Offer price cur\u00adren\u00adcy. See cur\u00adren\u00adcy dic\u00adtio\u00adnary<\/a>.<\/td><\/tr>
price.last_price_author<\/td>String<\/td>1002345\u20131<\/td>Sub\u00admit\u00adter of cur\u00adrent offer<\/td><\/tr>
price.type<\/td>String<\/td>route<\/td>Type of set\u00adtle\u00adment. Default is route<\/code>. For mul\u00adti\u00adfreights avail\u00adable val\u00adues: route<\/code>, ton<\/code>.<\/td><\/tr>
price.value<\/td>Float<\/td>450<\/td>Offer price val\u00adue (per haulage)<\/td><\/tr>
require\u00adments<\/td>String<\/td>null<\/td>Addi\u00adtion\u00adal requirements\/arrangements send by car\u00adri\u00ader, Dep\u00adre\u00adcat\u00aded field, val\u00adue always is null<\/code>.<\/td><\/tr>
sta\u00adtus<\/td>String<\/td>nego\u00adti\u00ada\u00adtion<\/td>Offer sta\u00adtus. <\/td><\/tr>
trans_id<\/td>String<\/td>1002345\u20132<\/td>Tran\u00adsId of the employ\u00adee of the com\u00adpa\u00adny who sub\u00admit\u00adted the price offer<\/td><\/tr>
trans\u00adports<\/td>Object<\/td><\/td>Offer details. Avail\u00adable for mul\u00adti\u00adfreights.<\/td><\/tr>
transports.count<\/td>Int<\/td>2<\/td>Num\u00adber of haulages offered by car\u00adri\u00ader<\/td><\/tr>
vat_id<\/td>String<\/td>PL234564534<\/td>Legal (tax) com\u00adpa\u00adny iden\u00adti\u00adfi\u00ader<\/td><\/tr>
ver\u00adsion<\/td>String<\/td>2<\/td>Ver\u00adsion num\u00adber required for reply\u00ading to the offer (impor\u00adtant for nego\u00adti\u00ada\u00adtion process)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n
\n
Response Body<\/h6>\n<\/div>\n\n\n\n
\n
[\n    {\n        \"carrier_offer_expiration_date\": null,\n        \"company_id\": 567347,\n        \"created_at\": \"2026-03-03T12:21:58.203Z\",\n        \"freight_id\": 3828332,\n        \"id\": \"3bf52d1c-74e5-4884-b60b-2a21f7cb2607\",\n        \"legal_name\": \"Carrier Transports\",\n        \"offer_expiration_date\": \"2026-03-03T22:37:00.000Z\",\n        \"price\": {\n            \"currency\": \"pln\",\n            \"last_price_author\": \"567347-2\",\n            \"type\": \"ton\",\n            \"value\": 890\n        },\n        \"requirements\": null,\n        \"status\": \"negotiation\",\n        \"trans_id\": \"567347-2\",\n        \"transports\": {\n            \"count\": 2\n        },\n        \"vat_id\": \"PL1234565\",\n        \"version\": 2\n    },\n    {\n        \"carrier_offer_expiration_date\": null,\n        \"company_id\": 567349,\n        \"created_at\": \"2026-03-03T12:17:43.599Z\",\n        \"freight_id\": 3828332,\n        \"id\": \"0918e084-3d40-4bd0-8d1c-c20e7109cdb8\",\n        \"legal_name\": \"Spedex GmbH\",\n        \"offer_expiration_date\": \"2026-03-03T22:37:00.000Z\",\n        \"price\": {\n            \"currency\": \"eur\",\n            \"last_price_author\": \"1002345-1\",\n            \"type\": \"ton\",\n            \"value\": 120\n        },\n        \"requirements\": null,\n        \"status\": \"negotiation\",\n        \"trans_id\": \"567349-1\",\n        \"transports\": {\n            \"count\": 2\n        },\n        \"vat_id\": \"DE7775898640\",\n        \"version\": 3\n    }\n]<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example response body<\/h6>\n\n\n\n
No offers for freight
or
you are not the con\u00adtact per\u00adson for this freight<\/p>\n<\/div>\n\n\n\n
\n
[]<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
Client errors (code 400)<\/h4>\n\n\n\n
HTTP 4xx sta\u00adtus codes indi\u00adcate client errors, mean\u00ading that the request could not be processed due to an issue on the client side. Below is a list of request-spe\u00adcif\u00adic errors.<\/p>\n\n\n\n
\n
\n
Example error 1<\/h6>\n\n\n\n
Freight does not exists or no access<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Page not found.\",\n    \"status\": 404,\n    \"title\": \"Not Found\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 2<\/h6>\n\n\n\n
Incor\u00adrect sta\u00adtus of freight<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"message\": \"Freight is not published\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 3<\/h6>\n\n\n\n
No offers for freight<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Offer read model not found\",\n    \"status\": 404,\n    \"title\": \"Not Found\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Down\u00adload list of price offers for select\u00aded freight with active pub\u00adli\u00adca\u00adtion. Down\u00adload list of price offers for select\u00aded freight with \u2026<\/p>\n","protected":false},"author":16,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"wp_typography_post_enhancements_disabled":false,"footnotes":""},"categories":[141,147],"tags":[],"class_list":["post-6310","post","type-post","status-publish","format-standard","hentry","category-freights-section","category-negotiation-n"],"acf":[],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t