Kuehne+Nagel RealTimeVisibility-Tracking API
Read cargo items and their telemetry readings for real-time visibility. Two GET operations, polled; no subscription or push channel is published.
OpenAPI Specification
{
"openapi" : "3.0.3",
"info" : {
"title" : "RealTimeVisibility-Tracking",
"description" : "The RealTimeVisibility-Tracking API offers functions to retrieve telemetry data for a shipment.",
"contact" : {
"name" : "RGS Shipment Store Team",
"email" : "developers.rgs-shipment-store@kuehne-nagel.com"
},
"version" : "v1",
"x-api-guideline-version" : "1.10.2",
"x-api-id" : "7ce972f4-9960-46b6-be69-43270c136889",
"x-api-version" : "1.0.0"
},
"servers" : [ {
"url" : "https://internal.api.kuehne-nagel.com/real-time-visibility/tracking/v1"
} ],
"security" : [ {
"default" : [ ]
} ],
"tags" : [ {
"name" : "cargoItems",
"description" : "Assets (possible types are PACKAGE, CONTAINER and UNKNOWN) belonging to a shipment."
}, {
"name" : "telemetry",
"description" : "Telemetry assigned to a cargo item (PACKAGE/CONTAINER/UNKNOWN)."
} ],
"paths" : {
"/cargo-items" : {
"get" : {
"tags" : [ "cargoItems" ],
"summary" : "Retrieves assets of a shipment. If the asset's type is UNKNOWN, it may be any type except CONTAINER or PACKAGE.",
"description" : "Retrieves assets belonging to a shipment. If the asset's type is UNKNOWN, it may be any type except CONTAINER or PACKAGE.",
"operationId" : "getCargoItems",
"parameters" : [ {
"name" : "trackingNumber",
"in" : "query",
"description" : "Shipment identifier",
"required" : true,
"style" : "form",
"explode" : true,
"schema" : {
"maxLength" : 20,
"type" : "string",
"example" : "9999999999"
}
}, {
"name" : "cursor",
"in" : "query",
"description" : "The cursor value after which data is retrieved (excluding the cursor itself). This value should be skipped when fetching first cursor.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"maxLength" : 10000,
"type" : "string",
"example" : "MQ=="
}
}, {
"name" : "pageSize",
"in" : "query",
"description" : "Page size value.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"example" : 10
}
} ],
"responses" : {
"200" : {
"description" : "Successful response",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/CargoItemPage"
},
"example" : {
"data" : [ {
"id" : "a6616562-5315-4867-9d70-ab76cde83d10",
"type" : "CONTAINER",
"key" : "CMAU1234567"
}, {
"id" : "2e5dc269-d84e-473c-9f9e-a39b2c823c3d",
"type" : "PACKAGE",
"key" : "ABCU1234567"
}, {
"id" : "2f7de517-8d85-47e9-993a-f8cce2507f78",
"type" : "CONTAINER",
"key" : "XYZU1234567"
} ],
"pageInfo" : {
"hasNextPage" : true,
"hasPreviousPage" : false,
"startCursor" : "Mg==",
"endCursor" : "NA=="
}
}
}
}
},
"400" : {
"description" : "Invalid request",
"content" : {
"application/problem+json" : {
"schema" : {
"$ref" : "#/components/schemas/Problem"
}
}
}
},
"404" : {
"description" : "Shipment not found",
"content" : {
"application/problem+json" : {
"schema" : {
"$ref" : "#/components/schemas/Problem"
}
}
}
},
"default" : {
"description" : "Error occurred - see message for more details",
"content" : {
"application/problem+json" : {
"schema" : {
"$ref" : "#/components/schemas/Problem"
}
}
}
}
},
"security" : [ {
"default" : [ ]
} ],
"x-auth-type" : "Application & Application User",
"x-throttling-tier" : "10KPerMin"
}
},
"/cargo-items/{cargoItemId}/telemetries" : {
"get" : {
"tags" : [ "telemetry" ],
"summary" : "Retrieves telemetry assigned to an asset (PACKAGE/CONTAINER/UNKNOWN).",
"description" : "Retrieves telemetry for an asset.",
"operationId" : "getCargoItemTelemetry",
"parameters" : [ {
"name" : "cargoItemId",
"in" : "path",
"description" : "Asset identifier",
"required" : true,
"style" : "simple",
"explode" : false,
"schema" : {
"maxLength" : 50,
"type" : "string",
"example" : "00000000-0000-0000-0000-000000000000"
}
}, {
"name" : "types",
"in" : "query",
"description" : "Telemetry types, separated by commas",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"maxLength" : 1000,
"type" : "string"
},
"example" : "GEO,BATTERY,LIGHT"
}, {
"name" : "cursor",
"in" : "query",
"description" : "The cursor value after which data is retrieved (excluding the cursor itself). This value should be skipped when fetching first cursor.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"maxLength" : 10000,
"type" : "string"
}
}, {
"name" : "pageSize",
"in" : "query",
"description" : "Page size value.",
"required" : false,
"style" : "form",
"explode" : true,
"schema" : {
"type" : "integer",
"example" : 10
}
} ],
"responses" : {
"200" : {
"description" : "Successful response",
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/TelemetryPage"
}
}
}
},
"400" : {
"description" : "Invalid request",
"content" : {
"application/problem+json" : {
"schema" : {
"$ref" : "#/components/schemas/Problem"
}
}
}
},
"404" : {
"description" : "Shipment or cargoItem not found",
"content" : {
"application/problem+json" : {
"schema" : {
"$ref" : "#/components/schemas/Problem"
}
}
}
},
"default" : {
"description" : "Error occurred - see message for more details",
"content" : {
"application/problem+json" : {
"schema" : {
"$ref" : "#/components/schemas/Problem"
}
}
}
}
},
"security" : [ {
"default" : [ ]
} ],
"x-auth-type" : "Application & Application User",
"x-throttling-tier" : "10KPerMin"
}
}
},
"components" : {
"schemas" : {
"Paging" : {
"properties" : {
"hasNextPage" : {
"type" : "boolean"
},
"hasPreviousPage" : {
"type" : "boolean"
},
"startCursor" : {
"maxLength" : 10000,
"type" : "string",
"example" : "Mg=="
},
"endCursor" : {
"maxLength" : 10000,
"type" : "string",
"example" : "NA=="
}
}
},
"CargoItemPage" : {
"type" : "object",
"properties" : {
"data" : {
"maxItems" : 1000,
"type" : "array",
"items" : {
"$ref" : "#/components/schemas/CargoItem"
}
},
"pageInfo" : {
"$ref" : "#/components/schemas/Paging"
}
}
},
"CargoItem" : {
"required" : [ "id" ],
"type" : "object",
"properties" : {
"id" : {
"maxLength" : 100,
"type" : "string",
"example" : "a6616562-5315-4867-9d70-ab76cde83d10"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "CONTAINER",
"x-extensible-enum" : [ "CONTAINER", "PACKAGE" ]
},
"key" : {
"maxLength" : 100,
"type" : "string",
"example" : "CMAU1234567"
}
},
"description" : "A single cargo asset (package or container)"
},
"TelemetryPage" : {
"type" : "object",
"properties" : {
"data" : {
"maxItems" : 1000,
"type" : "array",
"items" : {
"$ref" : "#/components/schemas/Telemetry"
}
},
"paging" : {
"$ref" : "#/components/schemas/Paging"
}
}
},
"Telemetry" : {
"oneOf" : [ {
"$ref" : "#/components/schemas/AssetOperationModeTelemetry"
}, {
"$ref" : "#/components/schemas/AssetTemperatureSetpointTelemetry"
}, {
"$ref" : "#/components/schemas/BatteryTelemetry"
}, {
"$ref" : "#/components/schemas/DoorTelemetry"
}, {
"$ref" : "#/components/schemas/GeoTelemetry"
}, {
"$ref" : "#/components/schemas/HumidityTelemetry"
}, {
"$ref" : "#/components/schemas/LightTelemetry"
}, {
"$ref" : "#/components/schemas/MotionTelemetry"
}, {
"$ref" : "#/components/schemas/PressureTelemetry"
}, {
"$ref" : "#/components/schemas/ShockTelemetry"
}, {
"$ref" : "#/components/schemas/TemperatureTelemetry"
}, {
"$ref" : "#/components/schemas/VibrationTelemetry"
}, {
"$ref" : "#/components/schemas/TiltTelemetry"
}, {
"$ref" : "#/components/schemas/AmbientAirTemperatureTelemetry"
}, {
"$ref" : "#/components/schemas/AmbientHumidityTelemetry"
}, {
"$ref" : "#/components/schemas/CargoTelemetry"
}, {
"$ref" : "#/components/schemas/CO2Telemetry"
}, {
"$ref" : "#/components/schemas/HumiditySetpointTelemetry"
}, {
"$ref" : "#/components/schemas/O2Telemetry"
}, {
"$ref" : "#/components/schemas/PowerTelemetry"
}, {
"$ref" : "#/components/schemas/ReturnTemperatureTelemetry"
}, {
"$ref" : "#/components/schemas/SupplyTemperature2Telemetry"
}, {
"$ref" : "#/components/schemas/BatteryPackTelemetry"
}, {
"$ref" : "#/components/schemas/TemperatureProbeTelemetry"
} ]
},
"OperationModeType" : {
"maxLength" : 100,
"type" : "string",
"description" : "Cooling Device mode.",
"example" : "START_STOP",
"x-extensible-enum" : [ "START_STOP", "CONTINUOUS", "UNKNOWN" ]
},
"AssetOperationModeTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "ASSET_OPERATION_MODE",
"x-extensible-enum" : [ "ASSET_OPERATION_MODE" ]
},
"value" : {
"$ref" : "#/components/schemas/OperationModeType"
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "cba526e4-7d4e-43cf-8539-9dcdb03c04df"
}
}
},
"AssetTemperatureSetpointTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "ASSET_TEMPERATURE_SETPOINT",
"x-extensible-enum" : [ "ASSET_TEMPERATURE_SETPOINT" ]
},
"value" : {
"maximum" : 250,
"minimum" : -100,
"type" : "number",
"description" : "Asset temperature setpoint in degrees Celsius.",
"format" : "float",
"example" : 25.5
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"BatteryDetails" : {
"type" : "object",
"properties" : {
"isCharging" : {
"type" : "boolean",
"description" : "Logical value reflecting if battery is charging.",
"example" : true
},
"voltage" : {
"maximum" : 1000,
"minimum" : 0,
"type" : "number",
"description" : "Battery voltage measured in volts.",
"format" : "float",
"example" : 33.5
},
"percentage" : {
"maximum" : 100,
"minimum" : 0,
"type" : "number",
"description" : "Battery level expressed as a percentage.",
"format" : "float",
"example" : 1.5
}
}
},
"BatteryTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "BATTERY",
"x-extensible-enum" : [ "BATTERY" ]
},
"value" : {
"$ref" : "#/components/schemas/BatteryDetails"
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"DoorTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "DOOR",
"x-extensible-enum" : [ "DOOR" ]
},
"value" : {
"type" : "boolean",
"description" : "Boolean value indicating whether a 'Door Open' event has occurred.",
"example" : true
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"GeoMode" : {
"maxLength" : 100,
"type" : "string",
"description" : "Geo-location method utilized.",
"example" : "GPS",
"x-extensible-enum" : [ "GSM", "GPS" ]
},
"GeoLocationDetails" : {
"type" : "object",
"properties" : {
"latitude" : {
"maximum" : 90,
"minimum" : -90,
"type" : "number",
"description" : "Latitude in degrees.",
"format" : "float",
"example" : 36.847103
},
"longitude" : {
"maximum" : 180,
"minimum" : -180,
"type" : "number",
"description" : "Longitude in degrees.",
"format" : "float",
"example" : 141.78143
},
"altitude" : {
"maximum" : 100000,
"minimum" : -100000,
"type" : "number",
"description" : "Altitude in meters.",
"format" : "float",
"example" : 0
},
"heading" : {
"maximum" : 360,
"minimum" : 0,
"type" : "number",
"description" : "Heading in degrees.",
"format" : "float",
"example" : 31.3
},
"velocity" : {
"maximum" : 10000,
"minimum" : 0,
"type" : "number",
"description" : "Velocity in kilometers per hour.",
"format" : "float",
"example" : 42.67
},
"geoMode" : {
"$ref" : "#/components/schemas/GeoMode"
}
}
},
"GeoTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "GEO",
"x-extensible-enum" : [ "GEO" ]
},
"value" : {
"$ref" : "#/components/schemas/GeoLocationDetails"
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"HumidityTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "HUMIDITY",
"x-extensible-enum" : [ "HUMIDITY" ]
},
"value" : {
"maximum" : 100,
"minimum" : 0,
"type" : "number",
"description" : "Humidity measured as a percentage.",
"format" : "float",
"example" : 25.3
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"LightTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "LIGHT",
"x-extensible-enum" : [ "LIGHT" ]
},
"value" : {
"maximum" : 1000000,
"minimum" : 0,
"type" : "number",
"description" : "Light illuminance value in lux.",
"format" : "float",
"example" : 323.5
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"MotionTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "MOTION",
"x-extensible-enum" : [ "MOTION" ]
},
"value" : {
"type" : "boolean",
"description" : "Boolean value indicating whether a 'Motion Detected' event has occurred.",
"example" : false
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"PressureTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "PRESSURE",
"x-extensible-enum" : [ "PRESSURE" ]
},
"value" : {
"maximum" : 10000,
"minimum" : 0,
"type" : "number",
"description" : "Pressure value measured in hPa (hectopascals).",
"format" : "float",
"example" : 434.56
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"ShockTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "SHOCK",
"x-extensible-enum" : [ "SHOCK" ]
},
"value" : {
"$ref" : "#/components/schemas/ShockDetails"
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"ShockDetails" : {
"type" : "object",
"properties" : {
"magnitude" : {
"maximum" : 30,
"minimum" : 0,
"type" : "number",
"description" : "Magnitude of the highest shock measured in g's.",
"format" : "float",
"example" : 24.9
},
"xAxis" : {
"maximum" : 30,
"minimum" : -30,
"type" : "number",
"description" : "The most extreme acceleration along the x-axis measured in g's.",
"format" : "float",
"example" : 12.3
},
"yAxis" : {
"maximum" : 30,
"minimum" : -30,
"type" : "number",
"description" : "The most extreme acceleration along the y-axis measured in g's.",
"format" : "float",
"example" : -12.4
},
"zAxis" : {
"maximum" : 30,
"minimum" : -30,
"type" : "number",
"description" : "The most extreme acceleration along the z-axis measured in g's.",
"format" : "float",
"example" : -2.8
}
}
},
"TiltTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "TILT",
"x-extensible-enum" : [ "TILT" ]
},
"value" : {
"maximum" : 180,
"minimum" : -180,
"type" : "number",
"description" : "Tilt angle measured in degrees.",
"format" : "float",
"example" : -32.4
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"VibrationTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "VIBRATION",
"x-extensible-enum" : [ "VIBRATION" ]
},
"value" : {
"type" : "boolean",
"description" : "Boolean value indicating whether the 'Vibration Detected' event has occurred.",
"example" : true
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"TemperatureTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "TEMPERATURE",
"x-extensible-enum" : [ "TEMPERATURE" ]
},
"value" : {
"maximum" : 250,
"minimum" : -100,
"type" : "number",
"description" : "Temperature measured in degrees Celsius.",
"format" : "float",
"example" : 35.5
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"AmbientAirTemperatureTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "AMBIENT_AIR_TEMPERATURE",
"x-extensible-enum" : [ "AMBIENT_AIR_TEMPERATURE" ]
},
"value" : {
"maximum" : 250,
"minimum" : -250,
"type" : "number",
"description" : "Temperature in Celsius degrees of the air temperature outside the container.",
"format" : "float",
"example" : 35.5
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"AmbientHumidityTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "AMBIENT_HUMIDITY",
"x-extensible-enum" : [ "AMBIENT_HUMIDITY" ]
},
"value" : {
"maximum" : 100,
"minimum" : 0,
"type" : "number",
"description" : "Humidity percentage of the air outside the container.",
"format" : "float",
"example" : 25.3
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"CargoTelemetry" : {
"required" : [ "sensorId", "timeDate", "transmitDate", "type", "value" ],
"type" : "object",
"properties" : {
"transmitDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T16:22:38Z"
},
"timeDate" : {
"type" : "string",
"format" : "date-time",
"example" : "2024-09-04T14:24:38Z"
},
"type" : {
"maxLength" : 100,
"type" : "string",
"example" : "CARGO",
"x-extensible-enum" : [ "CARGO" ]
},
"value" : {
"type" : "boolean",
"description" : "Logical value reflecting if asset contains cargo.",
"example" : true
},
"sensorId" : {
"maxLength" : 100,
"type" : "string",
"example" : "6441f7f9-c814-4775-a1aa-3fc931f67469"
}
}
},
"CO2Details" : {
"type" : "object",
"properties" : {
"percentage" : {
"maximum" : 100,
"minimum" : 0,
"type" : "number",
"description" : "CO2 concentration as a percentage.",
"format" : "float",
"example" : 33.5
},
"setpoint" : {
"maximum" : 100,
"minimum" : 0,
"type" : "number",
"description" : "Asset (e.g. reefer) CO2 setpoint in percentage.",
"format" : "float",
"example"
# --- truncated at 32 KB (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/kuehne-nagel/refs/heads/main/openapi/kuehne-nagel-real-time-visibility-tracking-v1-openapi.json