{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Vehicles & Fleet Management","description":"The operational transportation management API. Full access to planning, tracking, invoicing, and integrations — built on the OTM5 open data standard.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"vehicles--fleet-management","__idx":0},"children":["Vehicles & Fleet Management"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage your vehicles, transport equipment (trailers, containers), fleets, sensors, and board computers through the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"vehicles","__idx":1},"children":["Vehicles"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-vehicle","__idx":2},"children":["Create a Vehicle"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/vehicle \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Truck NL-AB-12\",\n    \"licensePlate\": \"NL-AB-12\",\n    \"type\": \"truck\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"message\": \"OK\",\n  \"vehicle\": {\n    \"id\": \"vehicle-uuid\",\n    \"name\": \"Truck NL-AB-12\",\n    \"licensePlate\": \"NL-AB-12\",\n    \"type\": \"truck\",\n    \"createdAt\": \"2026-03-22T10:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-a-vehicle","__idx":3},"children":["Get a Vehicle"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/vehicle/{id}\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list-vehicles","__idx":4},"children":["List Vehicles"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/vehicles/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-vehicles","__idx":5},"children":["Search Vehicles"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api.otms.transportial.com/api/vehicles/0/20\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"type\": \"truck\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"vehicle-trips","__idx":6},"children":["Vehicle Trips"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get all trips assigned to a vehicle:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/vehicle/{id}/trips/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get trips within a date range:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/vehicle/{id}/trips:byDate/2026-03-01/2026-03-31\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transport-equipment","__idx":7},"children":["Transport Equipment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transport equipment represents trailers, containers, swap bodies, and other attachable equipment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-transport-equipment","__idx":8},"children":["Create Transport Equipment"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/transportEquipment \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Trailer T-001\",\n    \"licensePlate\": \"NL-TR-01\",\n    \"type\": \"trailer\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list-transport-equipment","__idx":9},"children":["List Transport Equipment"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/transportEquipments/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"extended-view","__idx":10},"children":["Extended View"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get equipment with full relation data:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/transportEquipments:extended/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"equipment-trips","__idx":11},"children":["Equipment Trips"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Trips for a specific piece of equipment\ncurl -X GET \"https://api.otms.transportial.com/api/transportEquipment/{id}/trips/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\n# Trips within a date range\ncurl -X GET \"https://api.otms.transportial.com/api/transportEquipment/{id}/trips:byDate/2026-03-01/2026-03-31\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fleets","__idx":12},"children":["Fleets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Group vehicles into fleets for organizational management."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-fleet","__idx":13},"children":["Create a Fleet"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/fleet \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Netherlands Fleet\",\n    \"vehicles\": [\n      { \"id\": \"vehicle-uuid-1\" },\n      { \"id\": \"vehicle-uuid-2\" }\n    ]\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list-fleets","__idx":14},"children":["List Fleets"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Full fleet data\ncurl -X GET \"https://api.otms.transportial.com/api/fleets/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\n# Light version (names and IDs only)\ncurl -X GET \"https://api.otms.transportial.com/api/fleets/light\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"vehicle-groups","__idx":15},"children":["Vehicle Groups"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Organize vehicles into logical groups:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/vehicleGroup \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Long-haul trucks\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sensors","__idx":16},"children":["Sensors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage IoT sensors attached to vehicles or equipment."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-sensor","__idx":17},"children":["Create a Sensor"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/sensor \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Temperature sensor - Trailer T-001\",\n    \"type\": \"temperature\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-sensor-types","__idx":18},"children":["Get Sensor Types"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET https://api.otms.transportial.com/api/sensor/types \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"read-sensor-value-at-a-specific-date","__idx":19},"children":["Read Sensor Value at a Specific Date"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/sensor/{id}/value/2026-03-22T14:00:00Z\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-sensor-updates-over-a-range","__idx":20},"children":["Get Sensor Updates Over a Range"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/sensors/{id}/updates/2026-03-22T00:00:00Z/2026-03-22T23:59:59Z\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"board-computers","__idx":21},"children":["Board Computers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage on-board computers installed in vehicles:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/boardComputer \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Transics TX-SMART\",\n    \"vehicleId\": \"vehicle-uuid\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list-board-computers","__idx":22},"children":["List Board Computers"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/boardComputers/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cameras","__idx":23},"children":["Cameras"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add cameras to vehicles for dashcam and security recording:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Add camera to vehicle\ncurl -X POST \"https://api.otms.transportial.com/api/vehicle/{vehicleId}/camera\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Front dashcam\"\n  }'\n\n# List cameras for a vehicle\ncurl -X GET \"https://api.otms.transportial.com/api/vehicle/{vehicleId}/cameras\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tires","__idx":24},"children":["Tires"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Track tire data for maintenance and compliance:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Create tire record\ncurl -X POST https://api.otms.transportial.com/api/tire \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Front left\",\n    \"brand\": \"Michelin\",\n    \"size\": \"315/80R22.5\"\n  }'\n\n# Get tires for a vehicle\ncurl -X GET \"https://api.otms.transportial.com/api/tires/vehicle/{vehicleId}/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\n# Get tires for transport equipment\ncurl -X GET \"https://api.otms.transportial.com/api/tires/transportEquipment/{equipmentId}/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tachograph-data","__idx":25},"children":["Tachograph Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Convert and process tachograph binary data:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/tachograph/convert/binary \\\n  -H \"Content-Type: application/octet-stream\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  --data-binary @tachograph-file.ddd\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fleet-insights","__idx":26},"children":["Fleet Insights"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get analytics for your fleet:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Vehicle trip insights\ncurl -X GET \"https://api.otms.transportial.com/api/insights/vehicle/{id}/trips/2026-03-01/2026-03-31\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\n# Fleet-wide trip insights\ncurl -X GET \"https://api.otms.transportial.com/api/insights/fleet/{id}/trips/2026-03-01/2026-03-31\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\n# Fleet move actions\ncurl -X GET \"https://api.otms.transportial.com/api/insights/fleet/{id}/moveActions/2026-03-01/2026-03-31\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\n# CO2 emissions\ncurl -X POST \"https://api.otms.transportial.com/api/insights/vehicles/CO2:byDateRange\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"vehicleIds\": [\"vehicle-uuid-1\", \"vehicle-uuid-2\"],\n    \"startDate\": \"2026-03-01\",\n    \"endDate\": \"2026-03-31\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":27},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assign vehicles and chauffeurs to trips with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/trips-and-planning"},"children":["Trips & Planning guide"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manage your drivers in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/chauffeurs-and-drivers"},"children":["Chauffeurs & Drivers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the full ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis"},"children":["API Reference"]}," for all vehicle endpoints"]}]}]},"headings":[{"value":"Vehicles & Fleet Management","id":"vehicles--fleet-management","depth":1},{"value":"Vehicles","id":"vehicles","depth":2},{"value":"Create a Vehicle","id":"create-a-vehicle","depth":3},{"value":"Get a Vehicle","id":"get-a-vehicle","depth":3},{"value":"List Vehicles","id":"list-vehicles","depth":3},{"value":"Search Vehicles","id":"search-vehicles","depth":3},{"value":"Vehicle Trips","id":"vehicle-trips","depth":3},{"value":"Transport Equipment","id":"transport-equipment","depth":2},{"value":"Create Transport Equipment","id":"create-transport-equipment","depth":3},{"value":"List Transport Equipment","id":"list-transport-equipment","depth":3},{"value":"Extended View","id":"extended-view","depth":3},{"value":"Equipment Trips","id":"equipment-trips","depth":3},{"value":"Fleets","id":"fleets","depth":2},{"value":"Create a Fleet","id":"create-a-fleet","depth":3},{"value":"List Fleets","id":"list-fleets","depth":3},{"value":"Vehicle Groups","id":"vehicle-groups","depth":2},{"value":"Sensors","id":"sensors","depth":2},{"value":"Create a Sensor","id":"create-a-sensor","depth":3},{"value":"Get Sensor Types","id":"get-sensor-types","depth":3},{"value":"Read Sensor Value at a Specific Date","id":"read-sensor-value-at-a-specific-date","depth":3},{"value":"Get Sensor Updates Over a Range","id":"get-sensor-updates-over-a-range","depth":3},{"value":"Board Computers","id":"board-computers","depth":2},{"value":"List Board Computers","id":"list-board-computers","depth":3},{"value":"Cameras","id":"cameras","depth":2},{"value":"Tires","id":"tires","depth":2},{"value":"Tachograph Data","id":"tachograph-data","depth":2},{"value":"Fleet Insights","id":"fleet-insights","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Vehicles & Fleet Management"}},"lastModified":"2026-03-22T21:04:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/vehicles-and-fleet","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}