Allows to get list of monitoring tasks.

Technical aspects

Url parameters and connection settings

  • URL: https://api.platform.trans.eu
  • Endpoint: /ext/loads-monitoring-api/v1/monitorings
  • Method: GET
  • Authorization: Bearer {access_token}
  • Content-type: application/json

Authorization

Authorization process is described here. Each API request must also consist of unique Api-key obtained during application registration together with client_id and client_secret.

Response body example

{"date_created": "2021-02-17T10:59:38.000Z",
"devices": [
            {
                "date_from": "2021-02-18T09:45:03.000Z",
                "date_to": null,
                "details": {
                    "device_id": 680224,
                    "kind": "lorry",
                    "manufacturer": null,
                    "model": null,
                    "name": "Name",
                    "registration_plate_number": "Name12345",
                    "vehicle_id": 231863
                },
                "id": "3df5aa3e-f1ed-4d6d-995e-4271607d34f3",
                "is_active": true,
                "is_tracked": true,
                "linked_monitoring_id": null,
                "type": "fleet",
                "way": null
            },
            {
                "date_from": "2021-02-18T09:45:03.000Z",
                "date_to": null,
                "details": {
                    "device_id": 681550,
                    "kind": "semi-trailer",
                    "manufacturer": null,
                    "model": null,
                    "name": "Name2",
                    "registration_plate_number": "Name54321",
                    "vehicle_id": 236490
                },
                "id": "704d6d77-4d52-45d7-9cad-d3f634db7396",
                "is_active": true,
                "is_tracked": true,
                "linked_monitoring_id": null,
                "type": "fleet",
                "way": null
            },
            {
                "date_from": "2021-02-18T09:45:03.000Z",
                "date_to": null,
                "details": {
                    "account_id": 771476,
                    "device_id": null,
                    "document_number": null,
                    "document_type": null,
                    "first_name": "Jan",
                    "last_name": "Driver",
                    "name": "Jan Driver",
                    "phone_number": null
                },
                "id": "8886347d-b7c7-48f1-bb7f-c313bc97db2a",
                "is_active": true,
                "is_tracked": true,
                "linked_monitoring_id": null,
                "type": "executor",
                "way": null
            }
        ],
        "finished_at": null,
        "id": "0e6139e1-6957-4d22-8915-61f81ad91cba",
        "info": "example monitoring info",
        "reference_number": "2021/02/0EV4",
        "role": "shipper",
        "spots": [
            {
                "id": "15b84868-0c2f-4e67-9b4d-28f3f659f2ce",
                "operations": [
                    {
                        "completed_at": null,
                        "is_completed": false,
                        "time_frame": {
                            "date_from": "2021-02-16T14:00:00.000Z",
                            "date_to": "2021-02-16T23:00:00.000Z"
                        },
                        "type": "loading"
                    }
                ],
                "owner_monitoring_id": "0e6139e1-6957-4d22-8915-61f81ad91cba",
                "place": {
                    "address": {
                        "country": "PL",
                        "locality": "Warszawa",
                        "name": null,
                        "number": "35",
                        "postcode": "00-010",
                        "street": "Sienkiewicza"
                    },
                    "coordinates": {
                        "latitude": 48.4977774,
                        "longitude": 35.0896543
                    }
                }
            },
            {
                "id": "ba4f4a2b-c40e-46a5-845c-cee1e989646f",
                "operations": [
                    {
                        "completed_at": null,
                        "is_completed": false,
                        "time_frame": {
                            "date_from": "2021-02-17T23:00:00.000Z",
                            "date_to": "2021-02-17T23:00:00.000Z"
                        },
                        "type": "unloading"
                    }
                ],
                "owner_monitoring_id": "0e6139e1-6957-4d22-8915-61f81ad91cba",
                "place": {
                    "address": {
                        "country": "PL",
                        "locality": "Wrocław",
                        "name": null,
                        "number": "1",
                        "postcode": "50-261",
                        "street": "J. Narodowej"
                    },
                    "coordinates": {
                        "latitude":52.52437,
                        "longitude":13.41053
                    }
                }
            }
        ],
        "status": "alert",
        "time_frame": {
            "date_from": "2021-02-16T13:30:00.000Z",
            "date_to": "2021-02-18T23:00:00.000Z"
        }
    },
{//next monitoring}
}