{"id":6314,"date":"2026-03-17T11:04:14","date_gmt":"2026-03-17T10:04:14","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=6314"},"modified":"2026-06-09T14:14:53","modified_gmt":"2026-06-09T12:14:53","slug":"get-freight-offer-details","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/get-freight-offer-details\/","title":{"rendered":"Get freight offer details"},"content":{"rendered":"\n
\n
\n

Down\u00adload details of select\u00aded nego\u00adti\u00ada\u00adtion offer for freight pub\u00adli\u00adca\u00adtion.<\/p>\n\n\n\n\n\n\n\n

Once the car\u00adri\u00ader has start\u00aded the nego\u00adti\u00ada\u00adtion with you, you can check the cur\u00adrent nego\u00adti\u00ada\u00adtion sta\u00adtus and its his\u00adto\u00adry. Data is also avail\u00adable for offers of accept\u00aded and archived freights.<\/p>\n\n\n\n

The offers-id<\/code> iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber in request can be tak\u00aden from the response of Get freight offer list<\/a> request.<\/p>\n<\/div>\n\n\n\n

\n
GET<\/strong>
\/ext\/freights-api\/v1\/freights\/offers\/{offers-id}<\/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\/offers\/{offer-id} 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>
car\u00adri\u00ader<\/td>Object<\/td><\/td>The car\u00adri\u00ader\u2019s com\u00adpa\u00adny respond\u00ading to the offer<\/td><\/tr>
carrier.address<\/td>Object<\/td><\/td>Car\u00adri\u00ader\u2019s com\u00adpa\u00adny address<\/td><\/tr>
carrier.address.country<\/td>String<\/td>\u201cde\u201d<\/td>Coun\u00adtry using ISO val\u00adues (see dic\u00adtio\u00adnary<\/a>)<\/td><\/tr>
carrier.address.locality<\/td>String<\/td>\u201cBerlin\u201d<\/td>City name<\/td><\/tr>
carrier.address.postal_code<\/td>String<\/td>\u201c09230\u201d<\/td>Postal code<\/td><\/tr>
carrier.address.street<\/td>String<\/td>\u201cMag\u00ada\u00adzin\u00adstrasse\u201d<\/td>Street name<\/td><\/tr>
carrier.company_id<\/td>Int<\/td>1013454<\/td>Car\u00adri\u00ader\u2019s com\u00adpa\u00adny Trans.eu offi\u00adceId<\/td><\/tr>
carrier.email<\/td>String<\/td>mmiller@company.com<\/td>Car\u00adri\u00ader\u2019s com\u00adpa\u00adny e\u2011mail address<\/td><\/tr>
carrier.legal_name<\/td>String<\/td>\u201cCom\u00adpa\u00adny GmbH\u201d<\/td>Car\u00adri\u00ader\u2019s com\u00adpa\u00adny name<\/td><\/tr>
carrier.telephone<\/td>String<\/td>\u201c0049 301234567\u201d<\/td>Car\u00adri\u00ader\u2019s com\u00adpa\u00adny tele\u00adphone num\u00adber<\/td><\/tr>
carrier.vat_id<\/td>String<\/td>\u201cDE999999999\u201d<\/td>Car\u00adri\u00ader\u2019s com\u00adpa\u00adny vat id<\/td><\/tr>
contact_employees<\/td>Array of Object<\/td><\/td>List of car\u00adri\u00ader\u2019s employ\u00adees assigned to freight nego\u00adti\u00ada\u00adtion<\/td><\/tr>
contact_employees.last_name<\/td>String<\/td>\u201cMiller\u201d<\/td>Sur\u00adname of assigned employ\u00adee<\/td><\/tr>
contact_employees.name<\/td>String<\/td>\u201cMax\u201d<\/td>First name of assigned employ\u00adee<\/td><\/tr>
contact_employees.trans_id<\/td>String<\/td>1013454\u20132<\/td>Tran\u00adsId of assigned employ\u00adee<\/td><\/tr>
id<\/td>String<\/td>e9db1379-b172-4506\u20138d5b-531b82a99703<\/td>Freight offer iden\u00adti\u00adfi\u00ader<\/td><\/tr>
negotiations_logs<\/td>Array of Object<\/td><\/td>List of price changes with addi\u00adtion\u00adal details, chrono\u00adlog\u00adi\u00adcal\u00adly descend\u00ading.<\/td><\/tr>
negotiations_logs.action<\/td>String<\/td>\u201cNEGOTIATION_PARTICIPANT_OFFER\u201d<\/td>Nego\u00adti\u00ada\u00adtion action type \u2014 see list of val\u00adues.<\/a><\/td><\/tr>
negotiations_logs.carrier_offer_expiration_date<\/td>String<\/td>null<\/td>Date and time of offer expi\u00adra\u00adtion<\/td><\/tr>
negotiations_logs.comment<\/td>String<\/td>null<\/td>Addi\u00adtion\u00adal com\u00adment, post\u00aded as \u201crequire\u00adments\u201d dur\u00ading offer cre\u00adation<\/td><\/tr>
negotiations_logs.created_at<\/td>String<\/td>\u201c2026\u201303-04T07:51:46.181Z\u201d<\/td>Date and time the offer was cre\u00adat\u00aded<\/td><\/tr>
negotiations_logs.created_by<\/td>Object<\/td><\/td>Details of user sub\u00admit\u00adting the offer<\/td><\/tr>
negotiations_logs.created_by.email<\/td>String<\/td>maxmiller@company.com<\/td>User email address<\/td><\/tr>
negotiations_logs.created_by.family_name<\/td>String<\/td>\u201cMiller\u201d<\/td>User name<\/td><\/tr>
negotiations_logs.created_by.given_name<\/td>String<\/td>\u201cMax\u201d<\/td>User sur\u00adname<\/td><\/tr>
negotiations_logs.created_by.id<\/td>Int<\/td>759284<\/td>User account id<\/td><\/tr>
negotiations_logs.created_by.telephone<\/td>String<\/td>\u201c0049 301234567\u201d<\/td>User tele\u00adphone num\u00adber<\/td><\/tr>
negotiations_logs.created_by.trans.id<\/td>String<\/td>\u201c1013454\u20132\u201d<\/td>User Tran\u00adsId<\/td><\/tr>
negotiations_logs.created_by_company_id<\/td>Int<\/td>1013454<\/td>User\u2019s com\u00adpa\u00adny offi\u00adceId<\/td><\/tr>
negotiations_logs.id<\/td>String<\/td>e9db1379-b172-4506\u20138d5b-531b82a99703<\/td>Freight offer iden\u00adti\u00adfi\u00ader<\/td><\/tr>
negotiations_logs.is_shipper<\/td>Boolean<\/td>False<\/td>Val\u00adue set to true <\/code>if offer was sent by ship\u00adper<\/td><\/tr>
negotiations_logs.price<\/td>Object<\/td><\/td>Offer price of nego\u00adta\u00adtion action<\/td><\/tr>
negotiations_logs.price.currency<\/td>String<\/td>\u201ceur\u201d<\/td>Price cur\u00adren\u00adcy<\/td><\/tr>
negotiations_logs.price.value<\/td>Float<\/td>\u201c600\u201d<\/td>Price val\u00adue<\/td><\/tr>
negotiations_logs.proposal_request_id<\/td>Int<\/td>0<\/td>Dep\u00adre\u00adcat\u00aded field. Always is 0.<\/td><\/tr>
offer_expiration_date<\/td>String<\/td><\/td>Date and time of pub\u00adlish\u00ader\u2019s offer expi\u00adra\u00adtion<\/td><\/tr>
price<\/td>Object<\/td><\/td>Cur\u00adrent offer price<\/td><\/tr>
price.currency<\/td>String<\/td>\u201ceur\u201d<\/td>Offer price cur\u00adren\u00adcy<\/td><\/tr>
price.value<\/td>Float<\/td>450<\/td>Offer price val\u00adue<\/td><\/tr>
sta\u00adtus<\/td>String<\/td>\u201cnego\u00adti\u00ada\u00adtion\u201d<\/td>Offer nego\u00adti\u00ada\u00adtion sta\u00adtus. <\/td><\/tr>
ver\u00adsion<\/td>Int<\/td>3<\/td>Ver\u00adsion of nego\u00adti\u00ada\u00adtion offer. The next call in this nego\u00adti\u00ada\u00adtion should have this num\u00adber.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\n
\n
Negotiations action types<\/h5>\n\n\n\n
The ship\u00adper com\u00adpa\u00adny is an own\u00ader of freight pub\u00adli\u00adca\u00adtion.
The car\u00adri\u00ader com\u00adpa\u00adny is the par\u00adtic\u00adi\u00adpant to the nego\u00adti\u00ada\u00adtions.<\/p>\n<\/div>\n\n\n\n
\n
Nego\u00adti\u00ada\u00adtion action<\/td>Descrip\u00adtion<\/td><\/tr>
NEGOTIATION_CREATED<\/td>The nego\u00adti\u00ada\u00adtions have start\u00aded.<\/td><\/tr>
NEGOTIATION_OWNER_ACCEPT<\/td>A user from the shipper\u2019s com\u00adpa\u00adny accept\u00aded the offer<\/td><\/tr>
NEGOTIATION_OWNER_OFFER<\/td>A user from the shipper\u2019s com\u00adpa\u00adny sub\u00admit\u00adted an offer<\/td><\/tr>
NEGOTIATION_OWNER_REJECT<\/td>A user from the ship\u00adper\u2019s com\u00adpa\u00adny reject\u00aded the offer and fin\u00adished the nego\u00adti\u00ada\u00adtions. Both users will no longer be able to par\u00adtic\u00adi\u00adpate in nego\u00adti\u00ada\u00adtions for this freight.<\/td><\/tr>
NEGOTIATION_OWNER_RENOUNCE<\/td>A user from the shipper\u2019s com\u00adpa\u00adny reject\u00aded the offer. Nego\u00adti\u00ada\u00adtions can start again.<\/td><\/tr>
NEGOTIATION_OWNER_WITHDRAW<\/td>A user from the shipper\u2019s com\u00adpa\u00adny with\u00addrew their last offer<\/td><\/tr>
NEGOTIATION_PARTICIPANT_ACCEPT<\/td>A user from the carrier\u2019s com\u00adpa\u00adny accept\u00aded the offer<\/td><\/tr>
NEGOTIATION_PARTICIPANT_OFFER<\/td>A user from the carrier\u2019s com\u00adpa\u00adny sub\u00admit\u00adted an offer<\/td><\/tr>
NEGOTIATION_PARTICIPANT_REJECT<\/td>A user from the car\u00adri\u00ader\u2019s com\u00adpa\u00adny  reject\u00aded the offer and fin\u00adished the nego\u00adti\u00ada\u00adtions. Both users will no longer be able to par\u00adtic\u00adi\u00adpate in nego\u00adti\u00ada\u00adtions for this freight.<\/td><\/tr>
NEGOTIATION_PARTICIPANT_RENOUNCE<\/td>A user from the shipper\u2019s com\u00adpa\u00adny reject\u00aded the offer. Nego\u00adti\u00ada\u00adtions can start again.<\/td><\/tr>
NEGOTIATION_PARTICIPANT_WITHDRAW<\/td>A user from the carrier\u2019s com\u00adpa\u00adny with\u00addrew their last offer<\/td><\/tr>
NEGOTIATION_WAS_TAKEN_OVER<\/td>A user from the shipper\u2019s com\u00adpa\u00adny took over the nego\u00adti\u00ada\u00adtion<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Response Body<\/h6>\n<\/div>\n\n\n\n
\n
{\n    \"carrier\": {\n        \"address\": {\n            \"country\": \"DE\",\n            \"locality\": \"Berlin\",\n            \"postal_code\": \"09230\",\n            \"street\": \"Magazinstrasse\"\n        },\n        \"company_id\": 1013454,\n        \"email\": \"mmiller@company.com\",\n        \"legal_name\": \"Company GmbH\",\n        \"telephone\": \"0049 301234567\",\n        \"vat_id\": \"DE99999999\"\n    },\n    \"contact_employees\": [\n        {\n            \"last_name\": \"Miller\",\n            \"name\": \"Max\",\n            \"trans_id\": \"1013865-1\"\n        }\n    ],\n    \"id\": \"e15d98f9-aebf-4812-b0c5-e441222ec833\",\n    \"negotiations_logs\": [\n        {\n            \"action\": \"NEGOTIATION_OWNER_ACCEPT\",\n            \"carrier_offer_expiration_date\": null,\n            \"comment\": null,\n            \"created_at\": \"2026-03-17T09:37:16.832Z\",\n            \"created_by\": {\n                \"email\": \"jkowalski@example.com\",\n                \"family_name\": \"Kowalski\",\n                \"given_name\": \"Jan\",\n                \"id\": 765361,\n                \"telephone\": null,\n                \"trans_id\": \"1007374-5\"\n            },\n            \"created_by_company_id\": 1007374,\n            \"id\": \"e15d98f9-aebf-4812-b0c5-e441222ec833\",\n            \"is_shipper\": true,\n            \"price\": {\n                \"currency\": \"eur\",\n                \"value\": 230\n            },\n            \"proposal_request_id\": 0\n        },\n        {\n            \"action\": \"NEGOTIATION_PARTICIPANT_OFFER\",\n            \"carrier_offer_expiration_date\": null,\n            \"comment\": null,\n            \"created_at\": \"2026-03-17T09:36:49.939Z\",\n            \"created_by\": {\n                \"email\": \"mmiller@company.com\",\n                \"family_name\": \"Miller\",\n                \"given_name\": \"Max\",\n                \"id\": 759284,\n                \"telephone\": \"0049 301234567\",\n                \"trans_id\": \"1013454-2\"\n            },\n            \"created_by_company_id\": 1013454,\n            \"id\": \"e15d98f9-aebf-4812-b0c5-e441222ec833\",\n            \"is_shipper\": false,\n            \"price\": {\n                \"currency\": \"eur\",\n                \"value\": 230\n            },\n            \"proposal_request_id\": 0\n        },\n        {\n            \"action\": \"NEGOTIATION_CREATED\",\n            \"carrier_offer_expiration_date\": null,\n            \"comment\": null,\n            \"created_at\": \"2026-03-17T09:36:49.939Z\",\n            \"created_by\": {\n                \"email\": \"jkowalski@example.com\",\n                \"family_name\": \"Kowalski\",\n                \"given_name\": \"Jan\",\n                \"id\": 765361,\n                \"telephone\": null,\n                \"trans_id\": \"1007374-5\"\n            },\n            \"created_by_company_id\": 1007374,\n            \"id\": \"e15d98f9-aebf-4812-b0c5-e441222ec833\",\n            \"is_shipper\": true,\n            \"price\": {\n                \"currency\": \"pln\",\n                \"value\": null\n            },\n            \"proposal_request_id\": 0\n        }\n    ],\n    \"offer_expiration_date\": null,\n    \"price\": {\n        \"currency\": \"eur\",\n        \"value\": 230\n    },\n    \"status\": \"acceptation\",\n    \"version\": 3\n}<\/code><\/pre><\/div>\n<\/div>\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
Offer does not exists or no access<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Negotiation 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\n\n\n
\n
\n
Example error 2<\/h6>\n\n\n\n
The offer belongs to anoth\u00ader employ\u00adee of your com\u00adpa\u00adny<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Access to freight forbidden (freight: 3824585, employee: 765361)\",\n    \"status\": 403,\n    \"title\": \"Forbidden\",\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 details of select\u00aded nego\u00adti\u00ada\u00adtion offer for freight pub\u00adli\u00adca\u00adtion. Down\u00adload details of select\u00aded nego\u00adti\u00ada\u00adtion offer for freight pub\u00adli\u00adca\u00adtion.<\/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-6314","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