{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Chauffeurs & Drivers","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":"chauffeurs--drivers","__idx":0},"children":["Chauffeurs & Drivers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage your drivers, their schedules, activities, certificates, and service cards through the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-a-chauffeur","__idx":1},"children":["Creating a Chauffeur"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/chauffeur \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"firstName\": \"Peter\",\n    \"lastName\": \"de Vries\"\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  \"chauffeur\": {\n    \"id\": \"chauffeur-uuid\",\n    \"firstName\": \"Peter\",\n    \"lastName\": \"de Vries\",\n    \"createdAt\": \"2026-03-22T10:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-a-chauffeur","__idx":2},"children":["Get a Chauffeur"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/chauffeur/{id}\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"list-chauffeurs","__idx":3},"children":["List Chauffeurs"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Paginated list\ncurl -X GET \"https://api.otms.transportial.com/api/chauffeurs/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n\n# Search with filters\ncurl -X POST \"https://api.otms.transportial.com/api/chauffeurs/0/20\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"firstName\": \"Peter\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"chauffeur-activities","__idx":4},"children":["Chauffeur Activities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Activities track what a chauffeur is doing — driving, resting, waiting, on-duty but not driving, etc."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-an-activity","__idx":5},"children":["Create an Activity"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/chauffeur/activity \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"chauffeurId\": \"chauffeur-uuid\",\n    \"type\": \"driving\",\n    \"startTime\": \"2026-03-22T08:00:00Z\",\n    \"endTime\": \"2026-03-22T12:30:00Z\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-activities-for-a-chauffeur","__idx":6},"children":["Get Activities for a Chauffeur"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/chauffeur/{id}/activities/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"activities-by-date-range","__idx":7},"children":["Activities by Date Range"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/chauffeur/{id}/activities: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":"chauffeur-trips","__idx":8},"children":["Chauffeur Trips"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get all trips assigned to a chauffeur:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/chauffeur/{id}/trips/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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/chauffeur/{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":"certificates","__idx":9},"children":["Certificates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Track driver certifications, licenses, and qualifications."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-certificate","__idx":10},"children":["Create a Certificate"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/certificate \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"ADR Certificate\",\n    \"type\": \"adr\",\n    \"expiresAt\": \"2027-06-15T00:00:00Z\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-certificates-for-a-chauffeur","__idx":11},"children":["Get Certificates for a Chauffeur"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/certificates/chauffeur/{chauffeurId}/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-certificates-for-a-business","__idx":12},"children":["Get Certificates for a Business"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/certificates/business/{businessId}/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"service-cards","__idx":13},"children":["Service Cards"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Manage fuel cards, toll cards, and other service cards assigned to drivers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-service-card","__idx":14},"children":["Create a Service Card"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.otms.transportial.com/api/serviceCard \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"name\": \"Shell fuel card\",\n    \"cardNumber\": \"1234-5678-9012\",\n    \"type\": \"fuel\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list-service-cards","__idx":15},"children":["List Service Cards"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/serviceCards/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-service-cards-for-a-chauffeur","__idx":16},"children":["Get Service Cards for a Chauffeur"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.otms.transportial.com/api/serviceCards/chauffeur/{chauffeurId}/0/20\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"chauffeur-insights","__idx":17},"children":["Chauffeur Insights"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get analytics and reports for drivers:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Action breakdown (driving, resting, waiting, etc.)\ncurl -X POST \"https://api.otms.transportial.com/api/insights/chauffeurs/actions:byDateRange\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"chauffeurIds\": [\"chauffeur-uuid\"],\n    \"startDate\": \"2026-03-01\",\n    \"endDate\": \"2026-03-31\"\n  }'\n\n# On-truck time\ncurl -X POST \"https://api.otms.transportial.com/api/insights/chauffeurs/onTruck:byDateRange\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"chauffeurIds\": [\"chauffeur-uuid\"],\n    \"startDate\": \"2026-03-01\",\n    \"endDate\": \"2026-03-31\"\n  }'\n\n# Border crossings\ncurl -X POST \"https://api.otms.transportial.com/api/insights/chauffeurs/borderCrossings:byDateRange\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -d '{\n    \"chauffeurIds\": [\"chauffeur-uuid\"],\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":18},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assign chauffeurs to trips in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/trips-and-planning"},"children":["Trips & Planning"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Manage your fleet in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/vehicles-and-fleet"},"children":["Vehicles & Fleet Management"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See the full ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis"},"children":["API Reference"]}," for all chauffeur endpoints"]}]}]},"headings":[{"value":"Chauffeurs & Drivers","id":"chauffeurs--drivers","depth":1},{"value":"Creating a Chauffeur","id":"creating-a-chauffeur","depth":2},{"value":"Get a Chauffeur","id":"get-a-chauffeur","depth":2},{"value":"List Chauffeurs","id":"list-chauffeurs","depth":2},{"value":"Chauffeur Activities","id":"chauffeur-activities","depth":2},{"value":"Create an Activity","id":"create-an-activity","depth":3},{"value":"Get Activities for a Chauffeur","id":"get-activities-for-a-chauffeur","depth":3},{"value":"Activities by Date Range","id":"activities-by-date-range","depth":3},{"value":"Chauffeur Trips","id":"chauffeur-trips","depth":2},{"value":"Certificates","id":"certificates","depth":2},{"value":"Create a Certificate","id":"create-a-certificate","depth":3},{"value":"Get Certificates for a Chauffeur","id":"get-certificates-for-a-chauffeur","depth":3},{"value":"Get Certificates for a Business","id":"get-certificates-for-a-business","depth":3},{"value":"Service Cards","id":"service-cards","depth":2},{"value":"Create a Service Card","id":"create-a-service-card","depth":3},{"value":"List Service Cards","id":"list-service-cards","depth":3},{"value":"Get Service Cards for a Chauffeur","id":"get-service-cards-for-a-chauffeur","depth":3},{"value":"Chauffeur Insights","id":"chauffeur-insights","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Chauffeurs & Drivers"}},"lastModified":"2026-03-22T21:04:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/chauffeurs-and-drivers","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}