Collection of freight spots – at least one loading and one unloading is required.
Object Fields
| Attribute | Type | Example | Mandatory | Description |
| description | String | description | No | Description of the loading or unloading place |
| name | String | warehouse 1 | No | Name of spot |
| operations | Array of Objects | Yes | Operations to be completed in given spot | |
| operations.operation_order | Int | 1 | Yes | Ordering of loading and unloading operations at a given spot — first operation always is 1 |
| operations.loads | Object | No | Array of loads to be loaded or unloaded during operation | |
| operations.loads.load_id | String | 5ff7201734799 | No | Reference to a previously defined load (see Object loads) |
| operations.loads.weight | Int | 7 | No | Weight of load to be loaded or unloaded in operation |
| operations.operation_time | Int | 60 | No | Time, in minutes, to perform the operation at the point. This option is only available for the Dock Scheduler and warehouse spots. |
| operations.timespans | Object | Yes | Timespan for selected operations | |
| operations.timespans.begin | Timestamp | “2026–02–16T14:00:00+01:00” | Yes | Beginning of time slot for loading or unloading operation given in publisher’s time zone — must be greater or equal today |
| operations.timespans.begin_local | Timestamp | “2026–02–16T13:00:00+00:00” | only response | Beginning of time slot for loading or unloading operation given in the local time zone of the spot |
| operations.timespans.end | Timestamp | “2026–02–16T14:00:00+01:00” | Yes | End of time slot for loading or unloading operation given in publisher’s time zone — must be greater than timespans.begin |
| operations.timespans.end_local | Timestamp | “2026–02–16T13:00:00+00:00” | only response | End of time slot for loading or unloading operation given in the local time zone of the spot |
| operations.timespans.timezone | String | “Europe/London” | only response | Local timezone of the spot |
| operations.type | String | “loading” | Yes | Acceptable values: loading, unloading, customs_clearance. The first place on the route required loading operation, the last place required unloading operation. |
| place | Object | Yes | Information related to single place on freight’s route | |
| place.address | Object | Yes | Address of the selected point | |
| place.address.country | String | PL | Yes | Country using ISO values (see dictionary) |
| place.address.description | String | head office | No | Address description |
| place.address.locality | String | Wrocław | Yes | City name |
| place.address.number | String | 12 | No | Property number |
| place.address.postal_code | String | 50–900 | Yes | Postal code |
| place.address.street | String | Transportowa | No | Street name |
| place.coordinates | Object | No | Longitude and latitude for selected point | |
| place.coordinates.latitude | Float | 53.35801 | No | Latitude of the point along the freight route |
| place.coordinates.longitude | Float | -2.16539 | No | Longitude of the point along the freight route |
| spot_order | Int | 1 | Yes | Ordering of spot places — first spot always is 1 |
Example Object Body
"spots": [
{
"description": null,
"name": null,
"operations": [
{
"loads": [],
"operation_order": 1,
"operation_time": null,
"timespans": {
"begin": "2026-01-02T13:04:18+01:00",
"begin_local": "2026-01-02T13:04:18+01:00",
"end": "2026-01-02T15:04:18+01:00",
"end_local": "2026-01-02T15:04:18+01:00",
"timezone": "Europe/Warsaw"
},
"type": "loading"
}
],
"place": {
"address": {
"country": "pl",
"description": null,
"locality": "Wrocław",
"number": "2-4",
"postal_code": "53-146",
"street": "Racławicka"
},
"coordinates": {
"latitude": 51.0825872,
"longitude": 17.0038841
}
},
"spot_order": 1
},
{
"description": null,
"name": null,
"operations": [
{
"loads": [],
"operation_order": 1,
"operation_time": null,
"timespans": {
"begin": "2026-01-03T13:04:18+01:00",
"begin_local": "2026-01-03T13:04:18+01:00",
"end": "2026-01-03T15:04:18+01:00",
"end_local": "2026-01-03T15:04:18+01:00",
"timezone": "Europe/Berlin"
},
"type": "customs_clearance"
}
],
"place": {
"address": {
"country": "de",
"description": null,
"locality": "Munich",
"number": null,
"postal_code": "80331",
"street": null
},
"coordinates": {
"latitude": 48.135612857,
"longitude": 11.573308153
}
},
"spot_order": 2
},
{
"description": null,
"name": null,
"operations": [
{
"loads": [],
"operation_order": 1,
"operation_time": null,
"timespans": {
"begin": "2026-01-05T13:04:18+01:00",
"begin_local": "2026-01-05T13:04:18+01:00",
"end": "2026-01-05T15:04:18+01:00",
"end_local": "2026-01-05T15:04:18+01:00",
"timezone": "Europe/San_Marino"
},
"type": "unloading"
}
],
"place": {
"address": {
"country": "it",
"description": null,
"locality": "Milan",
"number": null,
"postal_code": "20097",
"street": null
},
"coordinates": {
"latitude": 45.397205283,
"longitude": 9.21659417
}
},
"spot_order": 3
}
],