1. Trans.eu Api
  2. Freights section
  3. Negotiate freight offer

Negotiate freight offer

Sub­mit­ting an offer with a price in the freight nego­ti­a­tion process.

The offers-id iden­ti­fi­ca­tion num­ber in request can be tak­en from the response of Get freight offer details request for pub­lish­er’s side or from Get freight pro­pos­al by id request for par­tic­i­pan­t’s side of nego­ti­a­tions.

PATCH
/ext/freights-api/v1/freights/offers/{offer-id}/negotiate
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

Request Para­me­ters

Request Body

Successful Response

Response Fields

Response Body

Error Response

Client errors (400)

Gen­er­al API errors

Request Header
PATCH /ext/freights-api/v1/freights/offers/{offer-id}/negotiate 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}
Request Parameters
AttributeTypeExam­pleManda­to­ryDescrip­tion
pay­mentObjectNoPro­posed pay­ment con­di­tions
payment.priceObjectNoPro­posed price
payment.price.currencyStringeurNoPrice cur­ren­cy, default pln is set. See cur­ren­cy dic­tio­nary.
payment.price.typeStringrouteNoType of set­tle­ment.
Avail­able val­ues: route, ton. Default is route.
Ton val­ue allowed for mul­ti-freights only.
payment.price.valueFloat150YesPrice val­ue (range: 1 – 9 999 999,99)
target_employee_idString1013865–1NoUser’s Trans ID.
Des­ig­nat­ing an addi­tion­al per­son to whom we send the offer — allows you to start inde­pen­dent nego­ti­a­tions with anoth­er user.
trans­portsObjectNoTerms of nego­ti­at­ing mul­ti-freight trans­ports
transports.quantityInt2NoNum­ber of nego­ti­at­ed trans­ports — must be not greater than the cur­rent num­ber of trans­ports avail­able for nego­ti­a­tion
ver­sionInt4YesCur­rent nego­ti­a­tion ask­ing ver­sion — the same as returned in Get freight offers list or Get freight offer details (for pub­lish­er’s side) or returned in Get freight pro­pos­al (for par­tic­i­pan­t’s side)
Example Request Body
{
 "payment": {
    "price": {
     "currency": "eur", 
     "type": "route",
     "value": 220   
    }
  },
 "target_employee_id": "1013865-1",
 "transports": {
    "quantity": 1
  },
 "version": 4
}
Response Fields
AttributeTypeExam­pleDescrip­tion
car­ri­erObjectInfor­ma­tion about the car­ri­er com­pa­ny par­tic­i­pat­ing in the nego­ti­a­tions
carrier.company_idInt1013865Office ID of car­ri­er com­pa­ny
carrier.cooperationObjectCoop­er­a­tion sta­tus
carrier.cooperation.is_suspendedBooleanFalseDeter­mines whether coop­er­a­tion with this car­ri­er is sus­pend­ed
carrier.legal_nameStringLogis­tix ExpName of car­ri­er com­pa­ny
carrier.vat_idStringPL4574663803Tax id of car­ri­er com­pa­ny
created_atString2026–03-04T11:17:18.289ZDate and time of send­ing the cur­rent offer
idString33f16f7a-3547–41cc-a82f-fb42a906d5c3Offer id
priceObjectPro­posed price
price.currencyStringeurPrice cur­ren­cy
price.typeStringtonType of set­tle­ment. Avail­able val­ues: route, ton.
price.valueFloat126Price val­ue
ver­sionInt2Request­ed nego­ti­a­tion ask­ing ver­sion
was_negotiatedBooleanFalseTrue - You are the ini­tia­tor of the nego­ti­a­tions
False - The oth­er par­tic­i­pant in the nego­ti­a­tion is its ini­tia­tor
Response Body
{
    "carrier": {
        "company_id": 1013865,
        "cooperation": {
            "is_suspended": false
        },
        "legal_name": "Logistix Exp",
        "vat_id": "PL4574663803"
    },
    "created_at": "2026-03-04T11:17:18.289Z",
    "id": "33f16f7a-3547-41cc-a82f-fb42a906d5c3",
    "price": {
        "currency": "eur",
        "type": "ton",
        "value": 220
    },
    "version": 4,
    "was_negotiated": false
}

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

Nego­ta­tion is end­ed

{
    "detail": "Auction winner was already chosen",
    "status": 422,
    "title": "Unprocessable Entity",
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}
Example error 2

Trans­ports allowed only for mult-freights

{
    "detail": "Transports can not be negotiated for this offer",
    "status": 422,
    "title": "Unprocessable Entity",
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}
Example error 3

Incon­sis­tent price type

{
    "detail": "Offer price type is not valid",
    "status": 422,
    "title": "Unprocessable Entity",
    "type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}