{"id":6010,"date":"2026-02-20T11:59:28","date_gmt":"2026-02-20T10:59:28","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=6010"},"modified":"2026-04-15T14:51:37","modified_gmt":"2026-04-15T12:51:37","slug":"create-freight","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/create-freight\/","title":{"rendered":"Create freight"},"content":{"rendered":"\n
\n
\n

Cre\u00adat\u00ading a new freight with\u00adout the option of pub\u00adlish\u00ading.<\/p>\n\n\n\n\n\n\n\n

After suc\u00adcess\u00adful\u00adly exe\u00adcut\u00ading the method, you receive in response the freight details with the unique freight iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber id <\/strong>assigned when cre\u00adat\u00ading the new freight.
This method can only be used to cre\u00adate a work\u00ading copy of the freight for sub\u00adse\u00adquent man\u00adu\u00adal pub\u00adli\u00adca\u00adtion using any method on the Plat\u00adform.
The rules for com\u00adplet\u00ading data in the request are described in Freight cre\u00adation<\/a>.<\/p>\n<\/div>\n\n\n\n

\n
POST<\/strong>
\/ext\/freights-api\/v1\/freights<\/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
Request Para\u00adme\u00adters<\/a><\/p>\n<\/div>\n\n\n\n
\n
Request Body<\/a><\/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
Clients errors (400)<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n\n\n\n
\n
Gen\u00ader\u00adal API errors<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
\n
\n
Request Header<\/h6>\n<\/div>\n\n\n\n
\n
POST \/ext\/freights-api\/v1\/freights 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
Request Parameters<\/h6>\n\n\n\n
Attribute<\/td>Type<\/td>Exam\u00adple<\/td>Manda\u00adto\u00adry<\/td>Descrip\u00adtion<\/td><\/tr>
callback_url<\/td>String<\/td>http:\/\/example.com\/msg<\/td>No<\/td>The return address pro\u00advid\u00aded by the client to receive freight and pub\u00adli\u00adca\u00adtion event sta\u00adtus\u00ades. See list of avail\u00adable event sta\u00adtus\u00ades<\/a>.<\/td><\/tr>
capac\u00adi\u00adty<\/td>Float<\/td>24<\/td>Yes<\/td>Total freight capac\u00adi\u00adty in tonnes. This val\u00adue is being val\u00adi\u00addat\u00aded in com\u00adpar\u00adi\u00adson to the sum of all loads weight
(range: 0,001 \u2013 100000)<\/td><\/tr>
height<\/td>Float<\/td>3.2<\/td>No<\/td>Expected\/required vehi\u00adcle height (range: 0.01\u201310)<\/td><\/tr>
length<\/td>Float<\/td>5<\/td>No<\/td>Expected\/required vehi\u00adcle length (range: 0.01\u2013100)<\/td><\/tr>
loading_meters<\/td>Float<\/td>13.6<\/td>No<\/td>Total freight load\u00ading meters (range: 0,01 \u2014 417)<\/td><\/tr>
loads (see details<\/a>)<\/td>Array of Objects<\/td><\/td>No<\/td>Col\u00adlec\u00adtion of freight loads. It is pos\u00adsi\u00adble to send emp\u00adty array of loads, nev\u00ader\u00adthe\u00adless an array has to be set<\/td><\/tr>
require\u00adments (see details<\/a>)<\/td>Object<\/td><\/td>Yes<\/td>Main freight require\u00adments<\/td><\/tr>
shipment_external_id<\/td>String<\/td>2023\/NWX\/1\/3<\/td>No<\/td>Exter\u00adnal iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td><\/tr>
spots (see details<\/a>)<\/td>Array of Objects<\/td><\/td>Yes<\/td>Col\u00adlec\u00adtion of freights\u2019 spots \u2013 at least one load\u00ading and one unload\u00ading is required<\/td><\/tr>
transit_time<\/td>Int<\/td>280<\/td>No<\/td>Time expressed in min\u00adutes (pos\u00adi\u00adtive inte\u00adger) for trans\u00adport. Must be less than the dif\u00adfer\u00adence between the last unload\u00ading and the first load\u00ading.<\/td><\/tr>
vol\u00adume<\/td>Float<\/td>21<\/td>No<\/td>Expected\/required vehi\u00adcle vol\u00adume (range: 0.01\u201310000)<\/td><\/tr>
width<\/td>Float<\/td>3.1<\/td>No<\/td>Expected\/required vehi\u00adcle width (range: 0.01\u201310)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n
\n
Example Request Body<\/h6>\n<\/div>\n\n\n\n
\n
{\n  \"callback_url\": \"http:\/\/example.com\/msg\",  \n  \"capacity\": 15.1,\n  \"height\":9.1,\n  \"length\":6.1,\n  \"loading_meters\": 7.2,\n  \"requirements\": {\n    \"is_ftl\": true,\n    \"required_truck_bodies\": [\n      \"dump-truck\"\n    ],\n    \"vehicle_size\": \"lorry\"\n  },\n  \"shipment_external_id\": \"1111\",\n  \"spots\": [\n    {\n      \"spot_order\": 1,\n      \"operations\": [\n        {\n          \"operation_order\": 1,\n          \"type\": \"loading\",\n          \"timespans\": {\n            \"begin\": \"2026-02-23T10:30:58+01:00\",\n            \"end\": \"2026-02-23T12:30:58+01:00\"\n          }\n        }\n      ],\n      \"place\": {\n        \"address\": {\n          \"country\": \"PL\",\n          \"postal_code\": \"54-128\",\n          \"locality\": \"Wroclaw\"\n        }\n      }\n    },\n    {\n      \"spot_order\": 2,\n      \"operations\": [\n        {\n          \"operation_order\": 1,\n          \"type\": \"unloading\",\n          \"timespans\": {\n            \"begin\": \"2026-02-26T10:30:58+01:00\",\n            \"end\": \"2026-02-26T12:30:58+01:00\"\n          }\n        }\n      ],\n      \"place\": {\n        \"address\": {\n          \"country\": \"IT\",\n          \"postal_code\": \"20097\",\n          \"locality\": \"Milan\"\n        }\n      }\n    }\n  ],\n  \"volume\":12.1,\n  \"width\": 6.6\n}<\/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>
accepted_price<\/td>Object<\/td>null<\/td>Final price for freight accept\u00aded dur\u00ading pub\u00adli\u00adca\u00adtion and nego\u00adti\u00ada\u00adtion process. Always null <\/code>in this request.<\/td><\/tr>
capac\u00adi\u00adty<\/td>Float<\/td>22.1<\/td>Total freight capac\u00adi\u00adty in tonnes.<\/td><\/tr>
car\u00adri\u00ader<\/td>Object<\/td>null<\/td>Car\u00adri\u00ader select\u00aded dur\u00ading pub\u00adli\u00adca\u00adtion and nego\u00adti\u00ada\u00adtion process. Always null <\/code>in this request.<\/td><\/tr>
contact_employees<\/td>Array of Objects<\/td><\/td>List of employ\u00adees assigned to freight nego\u00adti\u00ada\u00adtion. Always pub\u00adlish\u00ader in this request.<\/td><\/tr>
contact_employees.last_name<\/td>String<\/td>Nowak<\/td>Sur\u00adname of assigned employ\u00adee<\/td><\/tr>
contact_employees.name<\/td>String<\/td>Jan<\/td>First name of assigned employ\u00adee<\/td><\/tr>
contact_employees.trans_id<\/td>String<\/td>13443\u20131<\/td>Tran\u00adsId of assigned employ\u00adee<\/td><\/tr>
dis\u00adtance<\/td>Int<\/td>34<\/td>Dis\u00adtance in meters from the point of load\u00ading to the point of unload\u00ading.<\/td><\/tr>
end_reason<\/td>String<\/td>null<\/td>Pub\u00adli\u00adca\u00adtion end rea\u00adson. Always null <\/code>in this request.<\/td><\/tr>
height<\/td>Float<\/td>3.1<\/td>Vehi\u00adcle height (range: 0.01\u201310)<\/td><\/tr>
id<\/td>Int<\/td>234923<\/td>Freight iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber, assigned auto\u00admat\u00adi\u00adcal\u00adly dur\u00ading cre\u00adation of a new freight.<\/td><\/tr>
is_first_buy<\/td>Boolean<\/td>False<\/td>Defines if price can be nego\u00adti\u00adat\u00aded or only accept\u00aded by car\u00adri\u00ader. Always null <\/code>in this request.<\/td><\/tr>
length<\/td>Float<\/td>12<\/td>Vehi\u00adcle length (range: 0.01\u2013100)<\/td><\/tr>
loading_meters<\/td>Float<\/td>23<\/td>Total freight load\u00ading meters (range: 0,01 \u2014 417)<\/td><\/tr>
loads (see details<\/a>)<\/td>Array of Objects<\/td><\/td>Col\u00adlec\u00adtion of freight loads.<\/td><\/tr>
publication_price<\/td>Object<\/td><\/td>Pub\u00adli\u00adca\u00adtion price infor\u00adma\u00adtion. Always null <\/code>in this request.<\/td><\/tr>
publication_status<\/td>String<\/td>new<\/td>Sta\u00adtus of the pub\u00adli\u00adca\u00adtion. Always null <\/code>in this request.<\/td><\/tr>
reference_number<\/td>String<\/td>FR\/2025\/12\/30\/2NNQ<\/td>Freight ref\u00ader\u00adence num\u00adber \u2014 a unique, auto\u00admat\u00adi\u00adcal\u00adly assigned busi\u00adness iden\u00adti\u00adfi\u00ader of the freight<\/td><\/tr>
require\u00adments (see details<\/a>)<\/td>Object<\/td><\/td>Main freight require\u00adments<\/td><\/tr>
shipment_external_id<\/td>String<\/td>2023\/NWX\/1\/3<\/td>Exter\u00adnal iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber<\/td><\/tr>
spots (see details<\/a>)<\/td>Array of Objects<\/td><\/td>Col\u00adlec\u00adtion of freights\u2019 spots. At least one load\u00ading and one unload\u00ading will occur.<\/td><\/tr>
sta\u00adtus<\/td>String<\/td>new<\/td>Freight sta\u00adtus. Always new <\/code>in this request. See oth\u00ader sta\u00adtus\u00ades<\/a>.<\/td><\/tr>
sur\u00adchages<\/td>Object<\/td>null<\/td>Sur\u00adchages for fixed routes. Always null <\/code>in this request.<\/td><\/tr>
transit_time<\/td>Int<\/td>460<\/td>Time expressed in min\u00adutes (pos\u00adi\u00adtive inte\u00adger) for trans\u00adport, if spec\u00adi\u00adfied.<\/td><\/tr>
vol\u00adume<\/td>Float<\/td>21<\/td>Vehi\u00adcle vol\u00adume (range 0.01\u201310000).<\/td><\/tr>
width<\/td>Float<\/td>3.1<\/td>Vehi\u00adcle width (range 0.01\u201310).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n
\n
Response Body<\/h6>\n<\/div>\n\n\n\n
\n
{\n    \"accepted_price\": null,\n    \"capacity\": 15.1,\n    \"carrier\": null,\n    \"contact_employees\": [\n        {\n            \"last_name\": \"Nowak\",\n            \"name\": \"Jan\",\n            \"trans_id\": \"1017374-1\"\n        }\n    ],\n    \"distance\": 1185000,\n    \"end_reason\": null,\n    \"height\": 9.1,\n    \"id\": 3828345,\n    \"is_first_buy\": null,\n    \"length\": 6.1,\n    \"loading_meters\": 7.2,\n    \"loads\": [],\n    \"publication_price\": null,\n    \"publication_status\": null,\n    \"reference_number\": \"FR\/2026\/02\/20\/2N21\",\n    \"requirements\": {\n        \"exemption_from_adr\": false,\n        \"is_ftl\": true,\n        \"monitoring\": \"required\",\n        \"other_requirements\": [],\n        \"required_adr_classes\": [],\n        \"required_door_types\": [],\n        \"required_tipper_trailer_additional_equipment\": [],\n        \"required_truck_bodies\": [\n            \"dump-truck\"\n        ],\n        \"required_ways_of_loading\": [],\n        \"shipping_remarks\": null,\n        \"temperature\": {\n            \"max\": null,\n            \"min\": null\n        },\n        \"transport\": {\n            \"count\": null,\n            \"schedule_type\": null,\n            \"settlement\": \"route\",\n            \"settlement_basis\": null,\n            \"total_weight\": null,\n            \"type\": \"ftl\"\n        },\n        \"vehicle_size\": \"lorry\"\n    },\n    \"shipment_external_id\": \"1111\",\n    \"spots\": [\n        {\n            \"description\": \"\",\n            \"name\": null,\n            \"operations\": [\n                {\n                    \"loads\": [],\n                    \"operation_order\": 1,\n                    \"operation_time\": null,\n                    \"timespans\": {\n                        \"begin\": \"2026-02-23T10:30:58+01:00\",\n                        \"begin_local\": \"2026-02-23T10:30:58+01:00\",\n                        \"end\": \"2026-02-23T12:30:58+01:00\",\n                        \"end_local\": \"2026-02-23T12:30:58+01:00\",\n                        \"timezone\": \"Europe\/Warsaw\"\n                    },\n                    \"type\": \"loading\"\n                }\n            ],\n            \"place\": {\n                \"address\": {\n                    \"country\": \"pl\",\n                    \"description\": null,\n                    \"locality\": \"Wroclaw\",\n                    \"number\": null,\n                    \"postal_code\": \"54-128\",\n                    \"street\": null\n                },\n                \"coordinates\": {\n                    \"latitude\": 51.142329074,\n                    \"longitude\": 16.937462521\n                }\n            },\n            \"spot_order\": 1\n        },\n        {\n            \"description\": \"\",\n            \"name\": null,\n            \"operations\": [\n                {\n                    \"loads\": [],\n                    \"operation_order\": 1,\n                    \"operation_time\": null,\n                    \"timespans\": {\n                        \"begin\": \"2026-02-26T10:30:58+01:00\",\n                        \"begin_local\": \"2026-02-26T10:30:58+01:00\",\n                        \"end\": \"2026-02-26T12:30:58+01:00\",\n                        \"end_local\": \"2026-02-26T12:30:58+01:00\",\n                        \"timezone\": \"Europe\/San_Marino\"\n                    },\n                    \"type\": \"unloading\"\n                }\n            ],\n            \"place\": {\n                \"address\": {\n                    \"country\": \"it\",\n                    \"description\": null,\n                    \"locality\": \"Milan\",\n                    \"number\": null,\n                    \"postal_code\": \"20097\",\n                    \"street\": null\n                },\n                \"coordinates\": {\n                    \"latitude\": 45.397205283,\n                    \"longitude\": 9.21659417\n                }\n            },\n            \"spot_order\": 2\n        }\n    ],\n    \"status\": \"new\",\n    \"surcharges\": [],\n    \"transit_time\": null,\n    \"volume\": 12.1,\n    \"width\": 6.6\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
Clients 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
No manda\u00adto\u00adry val\u00adue in capac\u00adi\u00adty field<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Failed Validation\",\n    \"status\": 422,\n    \"title\": \"Unprocessable Entity\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\",\n    \"validation_messages\": {\n        \"capacity\": {\n            \"value\": {\n                \"isEmpty\": \"Value is required and can't be empty\"\n            }\n        }\n    }\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 2<\/h6>\n\n\n\n
Incor\u00adrect date in spot oper\u00ada\u00adtion<\/p>\n<\/div>\n\n\n\n
\n
\"validation_messages\": {\n        \"spot_operation\": {\n            \"validation_error\": \"In one of spot.operation begin or end date is lower or equal today (UTC)\"\n        }\n    }<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 3<\/h6>\n\n\n\n
Vehi\u00adcle type not allowed for vehi\u00adcle size<\/p>\n<\/div>\n\n\n\n
\n
\"validation_messages\": {\n            \"vehicle_size_id\": {\n                \"invalid\": \"['7_silos'] is not valid for vehicle size: '1_bus'\"\n            }\n        }\n    }<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 4<\/h6>\n\n\n\n
Load\u00ading weight does not match capac\u00adi\u00adty<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Failed Validation\",\n    \"status\": 422,\n    \"title\": \"Unprocessable Entity\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\",\n    \"validation_messages\": {\n        \"capacity\": {\n            \"value\": {\n                \"loadingWeightGreaterThanCapacity\": \"Sum of loading weights is greater than freight capacity '15'\"\n            }\n        }\n    }\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Cre\u00adat\u00ading a new freight with\u00adout the option of pub\u00adlish\u00ading. Cre\u00adat\u00ading a new freight with\u00adout the option of pub\u00adlish\u00ading.<\/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":[143,141],"tags":[],"class_list":["post-6010","post","type-post","status-publish","format-standard","hentry","category-freight-n","category-freights-section"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":6010},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6010","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\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=6010"}],"version-history":[{"count":10,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6010\/revisions"}],"predecessor-version":[{"id":6493,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/6010\/revisions\/6493"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=6010"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=6010"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=6010"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}