{"id":1658,"date":"2020-04-28T08:27:17","date_gmt":"2020-04-28T06:27:17","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=1658"},"modified":"2026-03-17T11:03:02","modified_gmt":"2026-03-17T10:03:02","slug":"list-of-freight-offers-by-greight-id","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/general-information\/list-of-freight-offers-by-greight-id\/","title":{"rendered":"List of freight offers by freight ID"},"content":{"rendered":"\n<p>List of received price offers for spe\u00adcif\u00adic freight pub\u00adli\u00adca\u00adtion. With\u00addrawed offers or offers which expi\u00adra\u00adtion date has passed will dis\u00adap\u00adpear from the list.<\/p>\n\n\n\n<!--more-->\n\n\n\n<h2 class=\"wp-block-heading\">Url parameters and connection settings<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>URL:<\/strong> https:\/\/api.platform.trans.eu<\/li>\n\n\n\n<li><strong>End\u00adpoint:<\/strong> \/ext\/freights-api\/v1\/freights\/{freight-id}\/offers<\/li>\n\n\n\n<li><strong>Method:<\/strong> GET<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Headers:<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Con\u00adtent-type: application\/json<\/li>\n\n\n\n<li>Accept: application\/json<\/li>\n\n\n\n<li>Autho\u00adriza\u00adtion: Bear\u00ader {access_token}<\/li>\n\n\n\n<li>Api-key: {unique_ap\u00adp_api-key}<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Authorization and access<\/h2>\n\n\n\n<p>Autho\u00adriza\u00adtion process <a href=\"https:\/\/www.trans.eu\/api\/general-information\/authorization-process\/\" target=\"_blank\" rel=\"noopener\" title>is described here<\/a>. Each API request must also con\u00adsist of unique Api-key obtained dur\u00ading appli\u00adca\u00adtion reg\u00adis\u00adtra\u00adtion togeth\u00ader with client_id and client_secret.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Usage<\/h2>\n\n\n\n<p>After suc\u00adcess\u00adful freight pub\u00adli\u00adca\u00adtion to a group of car\u00adri\u00aders, there will be a list of pric\u00ading offers received.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Offer statuses:<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>waiting_for_accept,<\/li>\n\n\n\n<li>in_negotiation,<\/li>\n\n\n\n<li>accept\u00aded,<\/li>\n\n\n\n<li>reject\u00aded,<\/li>\n\n\n\n<li>fin\u00adished<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Status codes:<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>200 OK \u2014 list of received offers<\/li>\n\n\n\n<li>200 OK with emp\u00adty table \u2014 no offers received or freight expired<\/li>\n\n\n\n<li>404 OK \u2014 freight pub\u00adli\u00adca\u00adtion does\u00adn\u2019t exist or no freight access allowed<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Each list of offers contains of:<\/h2>\n\n\n\n<figure class=\"wp-block-table has-small-font-size\"><table><tbody><tr><td><strong>Field<\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Exam\u00adple<\/strong><\/td><td><strong>Descrip\u00adtion<\/strong><\/td><\/tr><tr><td>\n<div>\n<div>carrier_offer_expiration_date<\/div>\n<\/div>\n<\/td><td>Time\u00adstamp<\/td><td>2021\u201303-04T12:00:00+02:00<\/td><td>Time when car\u00adri\u00ader offer expires<\/td><\/tr><tr><td>company_id<\/td><td>Int<\/td><td>123<\/td><td>Iden\u00adti\u00adfies the com\u00adpa\u00adny that sub\u00admit\u00adted the price offer<\/td><\/tr><tr><td>created_at<\/td><td>String<\/td><td>2021\u201303-04T08:24:36+02:00<\/td><td>Date and time of cre\u00adat\u00ading the offer (UTC)<\/td><\/tr><tr><td>freight_id<\/td><td>Int<\/td><td><span style=\"font-weight: 400;\">641839<\/span><\/td><td>Id of freight for which the offers are sub\u00admit\u00adted<\/td><\/tr><tr><td>id<\/td><td>GUID<\/td><td>4a2dbtsd-bd6b-4c24-6t2c-256af1005591<\/td><td>Id of offer (impor\u00adtant for nego\u00adti\u00ada\u00adtion process)<\/td><\/tr><tr><td>offer_expiration_date<\/td><td>Time\u00adstamp<\/td><td>2021\u201303-04T12:00:00+02:00<\/td><td>The time when the exchange offer expires (the valid\u00adi\u00adty time is set auto\u00admat\u00adi\u00adcal\u00adly to 15 min\u00adutes)<\/td><\/tr><tr><td>price<\/td><td>Object<\/td><td><\/td><td>Pric\u00ading con\u00addi\u00adtions<\/td><\/tr><tr><td>price.currency<\/td><td>String<\/td><td>Eur<\/td><td><a href=\"https:\/\/www.trans.eu\/api\/general-information\/allowed-values\/\">Cur\u00adren\u00adcy of received offer<\/a><\/td><\/tr><tr><td>price.value<\/td><td>Int<\/td><td>2000<\/td><td>Price val\u00adue<\/td><\/tr><tr><td>require\u00adments<\/td><td>String<\/td><td>My addi\u00adtion\u00adal require\u00adments<\/td><td>Addi\u00adtion\u00adal requirements\/arrangements send by car\u00adri\u00ader<\/td><\/tr><tr><td>sta\u00adtus<\/td><td>String<\/td><td>Waiting_for_accept<\/td><td>Cur\u00adrent sta\u00adtus of offer<\/td><\/tr><tr><td>trans_id<\/td><td>String<\/td><td>123\u20131<\/td><td>Iden\u00adti\u00adfies employ\u00adee of the com\u00adpa\u00adny who sub\u00admit\u00adted the price offer<\/td><\/tr><tr><td>vat_id<\/td><td>String<\/td><td>PL111111<\/td><td>Legal (tax) com\u00adpa\u00adny iden\u00adti\u00adfi\u00ader<\/td><\/tr><tr><td>ver\u00adsion<\/td><td>String<\/td><td>3<\/td><td>Ver\u00adsion required for reply\u00ading to the offer (impor\u00adtant for nego\u00adti\u00ada\u00adtion process)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Json examples:<\/h2>\n\n\n\n<p>With\u00adout any price or accep\u00adtance response from car\u00adri\u00aders:<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>[]<\/code><\/pre><\/div>\n\n\n\n<p>With two price offer\u00adings from two dif\u00adfer\u00adent car\u00adri\u00aders:<\/p>\n\n\n\n<div class=\"hcb_wrap\"><pre class=\"prism line-numbers lang-json\" data-lang=\"JSON\"><code>[\n  {\n    \"carrier_offer_expiration_date\": null,\n    \"company_id\": 123,\n    \"created_at\": \"2021-03-04T13:39:09+02:00\",\n    \"freight_id\": 641839,\n    \"id\": \"4a2dbtsd-bd6b-4c24-6t2c-256af1005591\",\n    \"legal_name\": \"Example Company Name #1\",\n    \"offer_expiration_date\": \"2021-03-04T14:18:49+02:00\",\n    \"price\": {\n      \"currency\": \"eur\",\n      \"value\": 2000\n    },\n    \"status\": \"waiting_for_accept\",\n    \"trans_id\": \"123-1\",\n    \"vat_id\": \"PL1111111\",\n    \"version\": 3\n  },\n  {\n    \"carrier_offer_expiration_date\": null,\n    \"company_id\": 102,\n    \"created_at\": \"2021-03-04T13:29:19+02:00\",\n    \"freight_id\": 1234567,\n    \"id\": \"8b2dbtsd-bd6b-4c24-6t2c-256af1005591\",\n    \"legal_name\": \"Example Company Different Name\",\n    \"offer_expiration_date\": \"2021-03-04T14:19:49+02:00\",\n    \"price\": {\n      \"currency\": \"eur\",\n      \"value\": 2200\n    },\n    \"requirements\": null,\n    \"status\": \"waiting_for_accept\",\n    \"trans_id\": \"102-1\",\n    \"vat_id\": \"PL222222\",\n    \"version\": 3\n  }\n]<\/code><\/pre><\/div>\n","protected":false},"excerpt":{"rendered":"<p class=\"dont-break-out\">List of received price offers for spe\u00adcif\u00adic freight pub\u00adli\u00adca\u00adtion. With\u00addrawed offers or offers which expi\u00adra\u00adtion date has passed will dis\u00adap\u00adpear \u2026<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"wp_typography_post_enhancements_disabled":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-1658","post","type-post","status-publish","format-standard","hentry","category-general-information"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":1658},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1658","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=1658"}],"version-history":[{"count":1,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1658\/revisions"}],"predecessor-version":[{"id":5557,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/1658\/revisions\/5557"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=1658"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=1658"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=1658"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}