List of received price offers for freight publication.

Url parameters and connection settings

  • URL: https://api.platform.trans.eu
  • Endpoint: /ext/freights-api/v1/freights/{freight-id}/offers
  • Method: GET

Headers:

  • Content-type: application/json
  • Accept: application/json
  • Authorization: Bearer {access_token}

Authorization

Authorization process is described here.

For accessing freights API no additional scopes are set, therefore the scope parameter can be left empty. If 403 error is received, please contact API support.

Usage

After successful freight publication to a group of carriers, there will be pricing offers received.

Status codes:

  • 200 OK – list of received offers
  • 200 OK with empty table – no offers received or freight expired
  • 404 OK – freight doesn’t exist or no freight access

Each list of offers contains of:

Field Type Example Description
company_id int 123 Identifies the company that submitted the offer
created_at string 2020-04-24T08:24:36+02:00 Date and time of creating the offer (UTC)
freight_id int 12 Id of freight
id int 8 Id of offer
price Object Pricing conditions
price.currency string eur Currency of received offer
price.value int 1000 Price value
trans_id string 123-1 Identifies employee of the company who submitted the offer

Json example:

[
    {
        “company_id”: 123,
        “created_at”: “2020-04-24T08:24:36+02:00”,
        “freight_id”: 9876,
        “id”: 8765,
        “price”: {
            “currency”: “pln”,
            “value”: 1000
        },
        “trans_id”: “123-1”
    },
    {
        “company_id”: 234,
        “created_at”: “2020-04-24T08:34:31+02:00”,
        “freight_id”: 9876,
        “id”: 8766,
        “price”: {
            “currency”: “pln”,
            “value”: 1200
        },
        “trans_id”: “234-1”
    }
]