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”
}
]