Get Latest Vehicle Measurements

Retrieves the most recent measurement data for vehicles that were active within the last 24 hours.
If a vehicle was not in operation during this period, no measurement data will be returned.

Battery information returns the last received battery data within the past 24 hours.

Request

---

GET https://openapi.willog.io/hub/v1/vehicles/latest-measurements

Query Parameters

Name	Type	Required	Description
page	Number	false	Page number, default: 1
size	Number	false	Number of records, default: 500, max: 500
vehicleStatus	String	false	Vehicle status
measurementTypes	Array	true	Measurement data type

Vehicle Statuses

Name	Description
IDLE	Not in use
DRIVING	In operation

Measurement Types

Name	Description
TEMPERATURE	Temperature
HUMIDITY	Humidity
BATTERY	Battery

Example Request

GET /hub/v1/vehicles/latest-measurements?page=1&size=300&vehicleStatus=DRIVING&measurementTypes=TEMPERATURE&measurementTypes=HUMIDITY
Authorization: Bearer apiKey

Response

---

Response Body

Name	Type	Not-null	Description
items	Array	true	Array of response data
items[].identifier	String	true	Vehicle identifier
items[].identifierType	String	true	Vehicle identifier type
items[].vehicleStatus	String	true	Vehicle status
items[].latestMeasurements	Array	true	Latest measurements from mapped devices
items[].latestMeasurements[].serial	String	true	Device serial number
items[].latestMeasurements[].time	Unix Timestamp(ms)	false	Measurement timestamp
items[].latestMeasurements[].temperature	Number	false	Temperature data
items[].latestMeasurements[].humidity	Number	false	Humidity data
items[].latestMeasurements[].battery	Object	false	Device latest battery info
items[].latestMeasurements[].battery.value	Number	true	Battery value
items[].latestMeasurements[].battery.measuredAt	Unix Timestamp(ms)	true	Battery measurement time
pagination	Object	true	Pagination metadata
pagination.page	Number	true	Requested page number
pagination.totalPages	Number	true	Total page count
pagination.size	Number	true	Requested number of records
pagination.total	Number	true	Total record count

identifier Types

Name	Description
CAR_LICENSE_NUMBER	License plate number

Example Response

HTTP/1.1 200 OK

{
    "items": [
        {
            "identifier": "vehicle-001",
            "identifierType": "CAR_LICENSE_NUMBER",
            "vehicleStatus": "DRIVING",
            "latestMeasurements": [
                {
                    "serial": "device-serial-1",
                    "time": 1738741600000,
                    "temperature": 36.5,
                    "humidity": 55,
                    "battery": {
                        "value": 85,
                        "measuredAt": 1738742000000
                    }
                },
                {
                    "serial": "device-serial-2",
                    "time": 1738741600000,
                    "temperature": null,
                    "humidity": 60,
                    "battery": {
                        "value": 90,
                        "measuredAt": 1738742100000
                    }
                }
            ]
        },
        {
            "identifier": "vehicle-002",
            "identifierType": "CAR_LICENSE_NUMBER",
            "vehicleStatus": "IDLE",
            "latestMeasurements": []
        }
    ],
    "pagination": {
        "page": 1,
        "size": 100,
        "total": 2,
        "totalPages": 1
    }
}

Error Responses

- Invalid Token or API Key

HTTP/1.1 400 Bad Request

{
    "code": "A0010"
}

- Invalid Request Parameters

HTTP/1.1 400 Bad Request

{
    "code": "E0021"
}