{"openapi":"3.1.0","info":{"title":"Proaction Telematics API","version":"1.16.0","description":"Standalone customer-authorized telematics API. Preview contract: availability depends on the deployed environment and authorized connection; extended telemetry requires explicit opt-in and provider validation. Missing means unknown, never zero. Usage is observed engine runtime, not productive work."},"servers":[{"url":"{origin}","variables":{"origin":{"default":"https://telematics.example.test","description":"Replace with the actual dedicated API origin. This default is a placeholder."}}}],"components":{"securitySchemes":{"applicationSecret":{"type":"http","scheme":"bearer","description":"Server-side sk_prod_ or sk_sandbox_ application secret. Sync routes additionally require the independently approved Connection-Token header."},"consumerKey":{"type":"http","scheme":"bearer","description":"Server-side pt_ consumer key with an explicit connection grant. Do not embed it in a browser."}},"schemas":{"GroupInventoryCapability":{"type":"object","properties":{"optInConfig":{"type":"string","const":"groupInventory"},"defaultEnabled":{"type":"boolean","const":false},"selection":{"type":"string","const":"explicit_approved_ids"},"maxGroupIds":{"type":"number","const":100},"parentResolution":{"type":"string","const":"approved_groups_only"},"raw":{"type":"string","const":"unsupported"},"sourceTimestamps":{"type":"string","const":"unsupported"}},"required":["optInConfig","defaultEnabled","selection","maxGroupIds","parentResolution","raw","sourceTimestamps"]},"GroupEntity":{"type":"object","properties":{"id":{"type":"string","pattern":"^group_[0-7][0-9A-HJKMNP-TV-Z]{25}$"},"sourceId":{"type":"string"},"provider":{"type":"string","enum":["samsara","motive","geotab"]},"name":{"type":"string"},"description":{"type":"string"},"parent":{"oneOf":[{"type":"string","pattern":"^group_[0-7][0-9A-HJKMNP-TV-Z]{25}$"},{"$ref":"#/components/schemas/GroupEntity"}]},"metadata":{"type":"object","properties":{"addedAt":{"type":"string","format":"date-time"},"modifiedAt":{"type":"string","format":"date-time"},"visibility":{"type":"string","const":"visible"},"parentResolution":{"type":"string","enum":["resolved","unresolved","root_or_unreported"]}},"required":["addedAt","modifiedAt","visibility"]}},"required":["id","sourceId","provider","metadata"]},"GroupInventoryResponse":{"type":"object","properties":{"status":{"type":"string","enum":["disabled","pending","available","stale","degraded"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/GroupEntity"}},"next":{"type":"string"},"fetchedAt":{"type":["string","null"],"format":"date-time"},"errorCode":{"type":["string","null"]},"retrieval":{"type":"string","const":"stored"}},"required":["status","results","fetchedAt","retrieval"]},"GroupReadResponse":{"anyOf":[{"$ref":"#/components/schemas/GroupInventoryResponse"},{"$ref":"#/components/schemas/GroupDirectoryResponse"}]},"GroupDirectoryResponse":{"type":"object","properties":{"retrieval":{"type":"string","const":"stored"},"sourceScope":{"type":"string","const":"credential_visible_directory"},"consistency":{"type":"string","const":"not_transactional"},"deletionEvidence":{"type":"string","const":"none"},"fetchedAt":{"type":["string","null"],"format":"date-time"},"capturedAt":{"type":["string","null"],"format":"date-time"},"errorCode":{"type":["string","null"]},"status":{"type":"string","enum":["pending","available","stale","degraded"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/GroupEntity"}},"next":{"type":"string"}},"required":["retrieval","sourceScope","consistency","deletionEvidence","fetchedAt","capturedAt","errorCode","status","results"]},"GroupDirectoryResult":{"type":"object","properties":{"retrieval":{"type":"string","const":"stored"},"sourceScope":{"type":"string","const":"credential_visible_directory"},"consistency":{"type":"string","const":"not_transactional"},"deletionEvidence":{"type":"string","const":"none"},"fetchedAt":{"type":["string","null"],"format":"date-time"},"capturedAt":{"type":["string","null"],"format":"date-time"},"errorCode":{"type":["string","null"]},"status":{"type":"string","enum":["available","stale","degraded"]},"data":{"$ref":"#/components/schemas/GroupEntity"}},"required":["retrieval","sourceScope","consistency","deletionEvidence","fetchedAt","capturedAt","errorCode","status","data"]},"CatalogGroupDirectory":{"type":"object","properties":{"releaseStatus":{"type":"string"},"enablement":{"type":"string"},"query":{"type":"string"},"identity":{"type":"string"},"consistency":{"type":"string","const":"not_transactional"},"deletionEvidence":{"type":"string","const":"none"},"maxRows":{"type":"integer","const":50000},"maxReferences":{"type":"integer","const":100000},"projectedByteLimit":{"type":"integer","const":67108864},"responseByteLimit":{"type":"integer","const":4194304},"pagination":{"type":"string"},"relations":{"type":"string"},"gaps":{"type":"array","items":{"type":"string"}}},"required":["releaseStatus","enablement","query","identity","consistency","deletionEvidence","maxRows","maxReferences","projectedByteLimit","responseByteLimit","pagination","relations","gaps"]},"VehicleMetadata":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"version":{"type":"number","const":1},"source":{"type":"string","enum":["samsara:vehicles","motive:vehicles","geotab:Device"]},"fields":{"type":"object","properties":{"make":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","minLength":1,"maxLength":1024},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"model":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","minLength":1,"maxLength":1024},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"year":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"integer","minimum":1886,"maximum":2200},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"status":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","enum":["active","inactive"]},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"providerStatus":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","minLength":1,"maxLength":1024},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"fuelType":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","enum":["gasoline","diesel","propane","electric","hybrid_gasoline","hybrid_diesel","biodiesel","compressed_natural_gas","liquefied_natural_gas","ethanol","hydrogen","plug_in_hybrid"]},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"sourceFuelType":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","minLength":1,"maxLength":1024},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"createdAt":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"updatedAt":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"licensePlate":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","minLength":1,"maxLength":1024},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"licensePlateRegion":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","minLength":1,"maxLength":1024},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"serialNumber":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","minLength":1,"maxLength":1024},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"groups":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":256},"name":{"type":"string","minLength":1,"maxLength":1024}},"required":["id"],"additionalProperties":false}},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"activeFrom":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]},"activeTo":{"oneOf":[{"type":"object","properties":{"status":{"type":"string","const":"available"},"value":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false},{"type":"object","properties":{"status":{"type":"string","enum":["missing","unsupported","invalid"]},"value":{"type":"null"},"source":{"type":"string","minLength":1,"maxLength":1024}},"required":["status","value","source"],"additionalProperties":false}]}},"required":["make","model","year","status","providerStatus","fuelType","sourceFuelType","createdAt","updatedAt","licensePlate","licensePlateRegion","serialNumber","groups","activeFrom","activeTo"],"additionalProperties":false}},"required":["version","source","fields"],"additionalProperties":false},"VehicleMetadataResponse":{"type":"object","properties":{"vehicleId":{"type":"string"},"status":{"type":"string","enum":["disabled","pending","not_in_current_roster","available","stale"]},"data":{"oneOf":[{"$ref":"#/components/schemas/VehicleMetadata"},{"type":"null"}]},"fetchedAt":{"type":["string","null"],"format":"date-time"},"rosterSeenAt":{"type":["string","null"],"format":"date-time"},"retrieval":{"type":"string","const":"stored"}},"required":["vehicleId","status","data","fetchedAt","rosterSeenAt","retrieval"]},"CatalogEnrichment":{"type":"object","properties":{"releaseStatus":{"type":"string"},"products":{"type":"array","items":{"type":"string","enum":["identity","images","specifications","build"]},"uniqueItems":true},"collection":{"type":"string"},"enablement":{"type":"string"},"measurements":{"type":"string"},"images":{"type":"string"}},"required":["releaseStatus","products","collection","enablement","measurements","images"]},"VehicleIdentity":{"type":"object","properties":{"vin":{"type":"string"},"make":{"type":["string","null"]},"model":{"type":["string","null"]},"manufacturer":{"type":["string","null"]},"trim":{"type":["string","null"]},"style":{"type":["string","null"]},"body":{"type":["string","null"]},"engine":{"type":["string","null"]},"drivetrain":{"type":["string","null"]},"transmission":{"type":["string","null"]},"year":{"type":["integer","null"]},"vinValid":{"type":["boolean","null"]},"checksum":{"type":["boolean","null"]},"ambiguous":{"type":["boolean","null"]},"yearAmbiguous":{"type":["boolean","null"]}},"required":["vin","year","make","model","manufacturer","trim","style","body","engine","drivetrain","transmission","vinValid","checksum","ambiguous","yearAmbiguous"]},"VehicleImages":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"kind":{"const":"vin_listing"},"source":{"type":"string"}},"required":["url","kind","source"]}}},"required":["images"]},"VehicleSpecifications":{"type":"object","properties":{"vin":{"type":"string"},"name":{"type":["string","null"]},"seatingCapacity":{"type":["integer","null"],"minimum":0},"measurementFormat":{"const":"provider_text"},"categories":{"type":"object","description":"Provider feature categories. Measurements retain reported units in text; these values are not normalized telemetry counters.","additionalProperties":{"type":"object","additionalProperties":{"type":["string","number","boolean","null"]}}}},"required":["vin","name","seatingCapacity","measurementFormat","categories"]},"VehicleBuild":{"type":"object","properties":{"vin":{"type":"string"},"make":{"type":"string"},"model":{"type":"string"},"manufacturer":{"type":"string"},"trim":{"type":"string"},"series":{"type":"string"},"style":{"type":"string"},"drivetrain":{"type":"string"},"engine":{"type":"string"},"transmission":{"type":"string"},"year":{"type":"integer"},"confidence":{"type":"number","minimum":0,"maximum":1},"interiorColor":{"type":"object","additionalProperties":{"type":"string"}},"exteriorColor":{"type":"object","additionalProperties":{"type":"string"}},"options":{"type":"object","additionalProperties":{"type":"string"}},"headUpDisplay":{"type":"boolean"},"rainSensingWipers":{"type":"boolean"}},"required":["vin"]},"IdentityValue":{"allOf":[{"$ref":"#/components/schemas/EnrichmentValue"},{"type":"object","properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/VehicleIdentity"},{"type":"null"}]}},"required":[]}]},"IdentitySection":{"allOf":[{"$ref":"#/components/schemas/EnrichmentSection"},{"type":"object","properties":{"product":{"const":"identity"},"data":{"anyOf":[{"$ref":"#/components/schemas/VehicleIdentity"},{"type":"null"}]}},"required":[]}]},"ImagesValue":{"allOf":[{"$ref":"#/components/schemas/EnrichmentValue"},{"type":"object","properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/VehicleImages"},{"type":"null"}]}},"required":[]}]},"ImagesSection":{"allOf":[{"$ref":"#/components/schemas/EnrichmentSection"},{"type":"object","properties":{"product":{"const":"images"},"data":{"anyOf":[{"$ref":"#/components/schemas/VehicleImages"},{"type":"null"}]}},"required":[]}]},"SpecificationsValue":{"allOf":[{"$ref":"#/components/schemas/EnrichmentValue"},{"type":"object","properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/VehicleSpecifications"},{"type":"null"}]}},"required":[]}]},"SpecificationsSection":{"allOf":[{"$ref":"#/components/schemas/EnrichmentSection"},{"type":"object","properties":{"product":{"const":"specifications"},"data":{"anyOf":[{"$ref":"#/components/schemas/VehicleSpecifications"},{"type":"null"}]}},"required":[]}]},"BuildValue":{"allOf":[{"$ref":"#/components/schemas/EnrichmentValue"},{"type":"object","properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/VehicleBuild"},{"type":"null"}]}},"required":[]}]},"BuildSection":{"allOf":[{"$ref":"#/components/schemas/EnrichmentSection"},{"type":"object","properties":{"product":{"const":"build"},"data":{"anyOf":[{"$ref":"#/components/schemas/VehicleBuild"},{"type":"null"}]}},"required":[]}]},"DriverId":{"type":"string","pattern":"^drv_[0-7][0-9A-HJKMNP-TV-Z]{25}$"},"Driver":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/DriverId"},"sourceId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9:_-]{0,255}$"},"provider":{"type":"string","enum":["samsara","motive","geotab"]},"status":{"type":"string","enum":["active","inactive"]},"firstName":{"type":"string"},"middleName":{"type":"string"},"lastName":{"type":"string"},"displayName":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{9,13}$"},"username":{"type":"string"},"license":{"type":"object","additionalProperties":false,"properties":{"number":{"type":"string"},"state":{"type":"string","enum":["AL","AK","AS","AZ","AR","CA","CO","CT","DE","FL","GA","GU","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MP","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","PR","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","VI","AB","BC","MB","NB","NL","NS","ON","PE","QC","SK","NT","NU","UM","YT","DC"]}},"required":[]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"groups":{"type":"array","maxItems":1000,"uniqueItems":true,"items":{"oneOf":[{"type":"string","pattern":"^group_[0-7][0-9A-HJKMNP-TV-Z]{25}$"},{"$ref":"#/components/schemas/GroupEntity"}]}},"groupMembership":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["available","stale","degraded","partial","pending","disabled","missing","invalid","unsupported"]},"scope":{"type":"string","enum":["approved_groups_only","credential_visible_directory"]},"sourceScope":{"type":"string","enum":["credential_visible","approved_groups","unknown"]},"fetchedAt":{"type":["string","null"],"format":"date-time"},"membershipCapturedAt":{"type":"string","format":"date-time"},"sourceAvailability":{"type":"string","enum":["available","missing","invalid","unsupported"]},"inventoryStatus":{"type":"string","enum":["available","pending","disabled","degraded","stale"]},"errorCode":{"type":"string","enum":["provider_auth_required","provider_config_invalid","provider_throttled","provider_unavailable","provider_response_changed","provider_scope_mismatch","group_persistence_unavailable","group_dispatch_unavailable"]}},"required":["status","scope","sourceScope","fetchedAt","membershipCapturedAt","sourceAvailability","inventoryStatus"]},"metadata":{"type":"object","additionalProperties":false,"properties":{"addedAt":{"type":"string","format":"date-time"},"modifiedAt":{"type":"string","format":"date-time"},"visibility":{"type":"string","const":"visible"}},"required":["addedAt","modifiedAt","visibility"]},"availability":{"type":"object","additionalProperties":false,"properties":{"firstName":{"type":"string","enum":["available","missing","invalid","unsupported"]},"middleName":{"type":"string","enum":["available","missing","invalid","unsupported"]},"lastName":{"type":"string","enum":["available","missing","invalid","unsupported"]},"displayName":{"type":"string","enum":["available","missing","invalid","unsupported"]},"email":{"type":"string","enum":["available","missing","invalid","unsupported"]},"phone":{"type":"string","enum":["available","missing","invalid","unsupported"]},"username":{"type":"string","enum":["available","missing","invalid","unsupported"]},"licenseNumber":{"type":"string","enum":["available","missing","invalid","unsupported"]},"licenseState":{"type":"string","enum":["available","missing","invalid","unsupported"]},"createdAt":{"type":"string","enum":["available","missing","invalid","unsupported"]},"updatedAt":{"type":"string","enum":["available","missing","invalid","unsupported"]}},"required":["firstName","middleName","lastName","displayName","email","phone","username","licenseNumber","licenseState","createdAt","updatedAt"]}},"required":["id","sourceId","provider","status","metadata","availability","groupMembership"]},"DriverDirectory":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["available","pending","stale","degraded"]},"retrieval":{"type":"string","const":"stored"},"fetchedAt":{"type":["string","null"],"format":"date-time"},"capturedAt":{"type":["string","null"],"format":"date-time"},"errorCode":{"type":["string","null"],"enum":[null,"provider_auth_required","provider_config_invalid","provider_throttled","provider_unavailable","provider_response_changed","provider_scope_mismatch","driver_persistence_unavailable"]},"results":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/Driver"}},"next":{"type":"string","pattern":"^[A-Za-z0-9_-]+$"}},"required":["status","retrieval","fetchedAt","capturedAt","errorCode","results"]},"DriverResult":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["available","stale","degraded"]},"retrieval":{"type":"string","const":"stored"},"fetchedAt":{"type":["string","null"],"format":"date-time"},"capturedAt":{"type":["string","null"],"format":"date-time"},"errorCode":{"type":["string","null"],"enum":[null,"provider_auth_required","provider_config_invalid","provider_throttled","provider_unavailable","provider_response_changed","provider_scope_mismatch","driver_persistence_unavailable"]},"driver":{"$ref":"#/components/schemas/Driver"}},"required":["status","retrieval","fetchedAt","capturedAt","errorCode","driver"]},"CatalogDrivers":{"type":"object","additionalProperties":false,"properties":{"releaseStatus":{"type":"string"},"authorization":{"type":"string"},"retrieval":{"type":"string"},"identity":{"type":"string"},"modification":{"type":"string"},"groupRelations":{"type":"string"},"membershipCapture":{"type":"string"},"gaps":{"type":"array","items":{"type":"string"}}},"required":["releaseStatus","authorization","retrieval","identity","modification","groupRelations","membershipCapture","gaps"]},"ExpandedVehicle":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/TripVehicleId"},"sourceId":{"type":"string"},"provider":{"type":"string","enum":["samsara","motive","geotab"]},"status":{"type":"string","enum":["active","inactive"]},"name":{"type":"string","maxLength":1024},"vin":{"type":"string","maxLength":1024},"make":{"type":"string","maxLength":1024},"model":{"type":"string","maxLength":1024},"year":{"type":"integer","minimum":1886,"maximum":2200},"fuelType":{"type":"string","enum":["gasoline","diesel","propane","electric","hybrid_gasoline","hybrid_diesel","biodiesel","compressed_natural_gas","liquefied_natural_gas","ethanol","hydrogen","plug_in_hybrid"]},"licensePlate":{"type":"object","additionalProperties":false,"properties":{"number":{"type":"string"},"state":{"type":"string"}},"required":[]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"groups":{"type":"array","maxItems":1000,"uniqueItems":true,"items":{"type":"string","pattern":"^group_[0-7][0-9A-HJKMNP-TV-Z]{25}$"}},"groupMembership":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["available","not_authorized","pending","missing","invalid","partial","stale","degraded"]},"scope":{"type":"string","const":"credential_visible_directory"},"sourceScope":{"type":"string","const":"credential_visible_reported_memberships"},"capturedAt":{"type":["string","null"],"format":"date-time"},"directoryFetchedAt":{"type":["string","null"],"format":"date-time"}},"required":["status","scope","sourceScope","capturedAt","directoryFetchedAt"]},"metadata":{"type":"object","additionalProperties":false,"properties":{"addedAt":{"type":"string","format":"date-time"},"modifiedAt":{"type":"string","format":"date-time"},"visibility":{"type":"string","enum":["visible","hidden_by_include_list","hidden_by_exclude_list","hidden_by_status"]}},"required":["addedAt","modifiedAt","visibility"]}},"required":["id","sourceId","provider","status","metadata"]},"TripId":{"type":"string","pattern":"^trp_[0-7][0-9A-HJKMNP-TV-Z]{25}$"},"TripVehicleId":{"type":"string","pattern":"^vcl_[0-7][0-9A-HJKMNP-TV-Z]{25}$","description":"Stable connection/account/source vehicle reference; current independently authorized account-bound profiles may be expanded."},"TripDriver":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/DriverId"},"sourceId":{"type":"string"},"provider":{"type":"string","enum":["samsara","motive","geotab"]},"status":{"type":"string","enum":["active","inactive"]},"firstName":{"type":"string"},"middleName":{"type":"string"},"lastName":{"type":"string"},"displayName":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"username":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"license":{"type":"object","additionalProperties":false,"properties":{"number":{"type":"string"},"state":{"type":"string"}},"required":[]},"metadata":{"type":"object","additionalProperties":false,"properties":{"addedAt":{"type":"string","format":"date-time"},"modifiedAt":{"type":"string","format":"date-time"}},"required":["addedAt","modifiedAt"]}},"required":["id","sourceId","provider","status","metadata"]},"Trip":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/TripId"},"sourceId":{"type":"string"},"provider":{"type":"string","enum":["samsara","motive","geotab"]},"vehicle":{"oneOf":[{"$ref":"#/components/schemas/TripVehicleId"},{"$ref":"#/components/schemas/ExpandedVehicle"}]},"driver":{"oneOf":[{"$ref":"#/components/schemas/DriverId"},{"$ref":"#/components/schemas/TripDriver"}]},"startedAt":{"type":"string","format":"date-time"},"endedAt":{"type":"string","format":"date-time"},"duration":{"type":"number","minimum":0,"description":"Milliseconds of source-reported driving duration or elapsed motion interval; see Units."},"distance":{"type":"number","minimum":0,"description":"Kilometres; omitted when missing/invalid. GPS distance and odometer difference remain distinct source bases."},"startLocation":{"type":"object","additionalProperties":false,"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180}},"required":["latitude","longitude"]},"endLocation":{"type":"object","additionalProperties":false,"properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180}},"required":["latitude","longitude"]},"metadata":{"type":"object","additionalProperties":false,"properties":{"addedAt":{"type":"string","format":"date-time"},"modifiedAt":{"type":"string","format":"date-time"}},"required":["addedAt","modifiedAt"]}},"required":["id","sourceId","provider","vehicle","startedAt","endedAt","duration","metadata"]},"TripPage":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["pending","available","degraded"]},"retrieval":{"type":"string","const":"stored"},"results":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/Trip"}},"next":{"type":"string","description":"Opaque current-grant/publication/relationship cursor; pass as cursor with unchanged filters."},"coverage":{"type":"object","additionalProperties":false,"properties":{"completedUnits":{"type":"integer","minimum":0},"selection":{"type":"string","const":"completed_trips_started_in_window"},"completeness":{"type":"string","const":"not_established"}},"required":["completedUnits","selection","completeness"]},"publishedAt":{"type":["string","null"],"format":"date-time"},"errorCode":{"type":["string","null"]}},"required":["status","retrieval","results","coverage","publishedAt","errorCode"]},"VehicleEntity":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/components/schemas/TripVehicleId"},"sourceId":{"type":"string"},"provider":{"type":"string","enum":["samsara","motive","geotab"]},"status":{"type":"string","enum":["active","inactive"]},"name":{"type":"string","maxLength":1024},"vin":{"type":"string","maxLength":1024},"make":{"type":"string","maxLength":1024},"model":{"type":"string","maxLength":1024},"year":{"type":"integer","minimum":1886,"maximum":2200},"fuelType":{"type":"string","enum":["gasoline","diesel","propane","electric","hybrid_gasoline","hybrid_diesel","biodiesel","compressed_natural_gas","liquefied_natural_gas","ethanol","hydrogen","plug_in_hybrid"]},"licensePlate":{"type":"object","additionalProperties":false,"properties":{"number":{"type":"string"},"state":{"type":"string"}},"required":[]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"groups":{"type":"array","maxItems":1000,"uniqueItems":true,"items":{"oneOf":[{"type":"string","pattern":"^group_[0-7][0-9A-HJKMNP-TV-Z]{25}$"},{"$ref":"#/components/schemas/GroupEntity"}]}},"groupMembership":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["available","not_authorized","pending","missing","invalid","partial","stale","degraded"]},"scope":{"type":"string","const":"credential_visible_directory"},"sourceScope":{"type":"string","const":"credential_visible_reported_memberships"},"capturedAt":{"type":["string","null"],"format":"date-time"},"directoryFetchedAt":{"type":["string","null"],"format":"date-time"}},"required":["status","scope","sourceScope","capturedAt","directoryFetchedAt"]},"metadata":{"type":"object","additionalProperties":false,"properties":{"addedAt":{"type":"string","format":"date-time"},"modifiedAt":{"type":"string","format":"date-time"},"visibility":{"type":"string","enum":["visible","hidden_by_include_list","hidden_by_exclude_list","hidden_by_status"]}},"required":["addedAt","modifiedAt","visibility"]}},"required":["id","sourceId","provider","status","metadata"]},"VehicleProfilePage":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["pending","available","degraded"]},"retrieval":{"type":"string","const":"stored"},"results":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/VehicleEntity"}},"next":{"type":"string"},"publishedAt":{"type":["string","null"],"format":"date-time"},"errorCode":{"type":["string","null"]},"selection":{"type":"string","const":"approved_source_vehicle_ids"},"completeness":{"type":"string","const":"not_established"}},"required":["status","retrieval","results","publishedAt","errorCode","selection","completeness"]},"VehicleReadResponse":{"oneOf":[{"$ref":"#/components/schemas/Vehicles"},{"$ref":"#/components/schemas/VehicleProfilePage"}]},"EnrichmentValue":{"type":"object","properties":{"status":{"type":"string","enum":["disabled","pending","available","missing","failed","blocked","missing_vin","invalid_vin"]},"data":{"type":["object","null"],"additionalProperties":true},"source":{"type":"string"},"adapterVersion":{"type":["string","null"]},"fetchedAt":{"type":["string","null"],"format":"date-time"},"errorCode":{"type":["string","null"]}},"required":["status","data","source","adapterVersion","fetchedAt","errorCode"]},"EnrichmentSection":{"allOf":[{"$ref":"#/components/schemas/EnrichmentValue"},{"type":"object","properties":{"vehicleId":{"type":"string"},"vin":{"type":["string","null"]},"product":{"type":"string","enum":["identity","images","specifications","build"]}},"required":["vehicleId","vin","product"]}]},"VehicleProfile":{"type":"object","properties":{"vehicleId":{"type":"string"},"vin":{"type":["string","null"]},"identity":{"$ref":"#/components/schemas/IdentityValue"},"images":{"$ref":"#/components/schemas/ImagesValue"},"specifications":{"$ref":"#/components/schemas/SpecificationsValue"},"build":{"$ref":"#/components/schemas/BuildValue"}},"required":["vehicleId","vin","identity","images","specifications","build"]},"UnitConversion":{"oneOf":[{"type":"object","properties":{"source":{"type":"string","enum":["meters","kilometers","miles"]},"normalized":{"type":"string","const":"meters"},"factor":{"type":"number","exclusiveMinimum":0}},"required":["source","normalized","factor"]},{"type":"object","properties":{"source":{"type":"string","enum":["seconds","milliseconds","hours"]},"normalized":{"type":"string","const":"seconds"},"factor":{"type":"number","exclusiveMinimum":0}},"required":["source","normalized","factor"]}]},"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"Window":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"}},"required":["startTime","endTime"]},"Connection":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"customer_id":{"type":"string"},"provider":{"type":"string"},"last_success_at":{"type":["string","null"],"format":"date-time"},"last_error_code":{"type":["string","null"]},"extended_last_success_at":{"type":["string","null"],"format":"date-time"},"extended_last_error_code":{"type":["string","null"]},"extended_next_retry_at":{"type":["string","null"],"format":"date-time"}},"required":["id","customer_id","provider"]},"Capabilities":{"type":"object","properties":{"id":{"type":"string"},"adapterVersion":{"type":"string"},"collection":{"type":"string","enum":["native_feed","poll"]},"fields":{"type":"object","additionalProperties":{"type":"string","enum":["supported","conditional","unsupported"]}},"faultModel":{"type":"string","enum":["complete_snapshot","explicit_records"]},"authentication":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"vehicleMetadata":{"$ref":"#/components/schemas/VehicleMetadataCapability"},"groupInventory":{"$ref":"#/components/schemas/GroupInventoryCapability"}},"required":["id","adapterVersion","fields","faultModel","vehicleMetadata","groupInventory"]},"VehicleMetadataCapability":{"type":"object","properties":{"optInConfig":{"type":"string","const":"vehicleMetadata"},"defaultEnabled":{"type":"boolean","const":false},"fields":{"type":"object","properties":{"make":{"type":"string","enum":["conditional","unsupported"]},"model":{"type":"string","enum":["conditional","unsupported"]},"year":{"type":"string","enum":["conditional","unsupported"]},"status":{"type":"string","enum":["conditional","unsupported"]},"providerStatus":{"type":"string","enum":["conditional","unsupported"]},"fuelType":{"type":"string","enum":["conditional","unsupported"]},"sourceFuelType":{"type":"string","enum":["conditional","unsupported"]},"createdAt":{"type":"string","enum":["conditional","unsupported"]},"updatedAt":{"type":"string","enum":["conditional","unsupported"]},"licensePlate":{"type":"string","enum":["conditional","unsupported"]},"licensePlateRegion":{"type":"string","enum":["conditional","unsupported"]},"serialNumber":{"type":"string","enum":["conditional","unsupported"]},"groups":{"type":"string","enum":["conditional","unsupported"]},"activeFrom":{"type":"string","enum":["conditional","unsupported"]},"activeTo":{"type":"string","enum":["conditional","unsupported"]}},"required":["make","model","year","status","providerStatus","fuelType","sourceFuelType","createdAt","updatedAt","licensePlate","licensePlateRegion","serialNumber","groups","activeFrom","activeTo"]}},"required":["optInConfig","defaultEnabled","fields"]},"ConnectSession":{"type":"object","properties":{"sessionId":{"type":"string","format":"uuid"},"expiresAt":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri"}},"required":["sessionId","expiresAt","url"]},"SessionStatus":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["created","started","consumed","complete","failed","cancelled","expired"]},"expires_at":{"type":"string","format":"date-time"},"enrollment_method":{"type":["string","null"],"enum":["oauth","api_token","service_account",null]},"disclosure_version":{"type":["string","null"]},"selected_signals":{"type":["array","null"],"items":{"type":"string","enum":["odometer","faults","engineHours","location"]},"minItems":1,"maxItems":4,"uniqueItems":true},"accepted_at":{"type":["string","null"],"format":"date-time"},"completed_at":{"type":["string","null"],"format":"date-time"}},"required":["id","status","expires_at"]},"Disconnect":{"type":"object","properties":{"connectionId":{"type":"string","format":"uuid"},"status":{"const":"disconnected"}},"required":["connectionId","status"]},"Vehicle":{"type":"object","properties":{"provider_id":{"type":"string"},"name":{"type":"string"},"vin":{"type":["string","null"]}},"required":["provider_id","name"]},"Vehicles":{"type":"object","properties":{"vehicles":{"type":"array","items":{"$ref":"#/components/schemas/Vehicle"}},"nextCursor":{"type":["string","null"]}},"required":["vehicles","nextCursor"]},"Fault":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"vehicle_id":{"type":"string"},"fault_key":{"type":"string"},"code":{"type":"string"},"description":{"type":["string","null"]},"opened_at":{"type":"string","format":"date-time"},"bootstrap":{"type":"boolean"}},"required":["id","vehicle_id","fault_key","code","opened_at","bootstrap"]},"Faults":{"type":"object","properties":{"faults":{"type":"array","items":{"$ref":"#/components/schemas/Fault"}},"nextCursor":{"type":["string","null"]}},"required":["faults","nextCursor"]},"FaultEvent":{"type":"object","properties":{"sequence":{"oneOf":[{"type":"integer"},{"type":"string"}]},"id":{"type":"string","format":"uuid"},"connection_id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"vehicle_id":{"type":"string"},"kind":{"type":"string","enum":["opened","cleared"]},"observed_at":{"type":"string","format":"date-time"},"bootstrap":{"type":"boolean"}},"required":["id","sequence","connection_id","vehicle_id","occurrence_id","kind","observed_at","bootstrap"]},"FaultEvents":{"type":"object","properties":{"events":{"type":"array","items":{"$ref":"#/components/schemas/FaultEvent"}},"nextCursor":{"type":"string"},"hasMore":{"type":"boolean"}},"required":["events","nextCursor","hasMore"]},"HistoryPoint":{"oneOf":[{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"location"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180}},"required":["latitude","longitude"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]},{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"odometer"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"meters":{"type":"number","minimum":0}},"required":["meters"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]},{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"engineHours"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"seconds":{"type":"number","minimum":0}},"required":["seconds"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]},{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"totalIdleTime"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"seconds":{"type":"number","minimum":0}},"required":["seconds"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]},{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"speed"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"value":{"type":"number","minimum":0}},"required":["value"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]},{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"heading"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"value":{"type":"number","minimum":0,"maximum":360}},"required":["value"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]},{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"fuelPercent"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"value":{"type":"number","minimum":0,"maximum":100}},"required":["value"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]},{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"batteryVoltage"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"value":{"type":"number","minimum":0}},"required":["value"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]},{"type":"object","properties":{"sequence":{"type":"string"},"metric":{"type":"string","const":"engineState"},"source":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"fetched_at":{"type":"string","format":"date-time"},"units":{"anyOf":[{"$ref":"#/components/schemas/UnitConversion"},{"type":"null"}]},"value":{"type":"object","properties":{"state":{"type":"string","enum":["on","off","idle"]}},"required":["state"]}},"required":["sequence","metric","source","observed_at","fetched_at","value"]}]},"History":{"type":"object","properties":{"vehicleId":{"type":"string"},"window":{"$ref":"#/components/schemas/Window"},"readings":{"type":"array","items":{"$ref":"#/components/schemas/HistoryPoint"}},"nextCursor":{"type":"string"},"hasMore":{"type":"boolean"}},"required":["vehicleId","window","readings","nextCursor","hasMore"]},"Counter":{"type":"object","properties":{"status":{"type":"string","enum":["missing","insufficient_data","partial","complete"]},"value":{"type":["number","null"]},"unit":{"type":"string","enum":["meters","seconds"]},"coverageSeconds":{"type":"number"},"coveragePercent":{"type":"number"},"sampleCount":{"type":"integer"},"excludedIntervals":{"type":"integer"},"sources":{"type":"array","items":{"type":"string"}},"intervals":{"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"amount":{"type":"number"}},"required":["startTime","endTime","amount"]}}},"required":["status","value","unit","coverageSeconds"]},"Utilization":{"type":"object","properties":{"vehicleId":{"type":"string"},"window":{"$ref":"#/components/schemas/Window"},"definition":{"const":"engine_runtime_over_observed_time_v1"},"maxObservationGapSeconds":{"const":1800},"engineRuntime":{"$ref":"#/components/schemas/Counter"},"engineNotRunning":{"$ref":"#/components/schemas/Counter"},"engineOnPercentOfObservedTime":{"type":["number","null"],"minimum":0,"maximum":100},"distance":{"$ref":"#/components/schemas/Counter"},"idleTime":{"$ref":"#/components/schemas/Counter"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["vehicleId","window","definition","engineRuntime","engineNotRunning","distance","idleTime","engineOnPercentOfObservedTime"]},"CounterReport":{"type":"object","properties":{"vehicleId":{"type":"string"},"window":{"$ref":"#/components/schemas/Window"},"definition":{"type":"string"},"metric":{"$ref":"#/components/schemas/Counter"},"limitations":{"type":"array","items":{"type":"string"}}},"required":["vehicleId","window","metric"]},"FleetUtilization":{"type":"object","properties":{"window":{"$ref":"#/components/schemas/Window"},"vehicles":{"type":"array","items":{"$ref":"#/components/schemas/Utilization"}},"nextCursor":{"type":["string","null"]}},"required":["window","vehicles","nextCursor"]},"Catalog":{"type":"object","properties":{"apiVersion":{"type":"string"},"catalogVersion":{"type":"string"},"releaseStatus":{"type":"string"},"reviewedAt":{"type":"string","format":"date"},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"unit":{"type":"string"},"kind":{"type":"string"},"freshnessSeconds":{"type":"integer"},"valueKey":{"type":"string"},"availability":{"type":"string"}},"required":[]}},"faults":{"type":"object"},"endpoints":{"type":"array","items":{"type":"object"}},"roadmap":{"type":"array","items":{"type":"object"}},"limits":{"type":"object"},"enrichment":{"$ref":"#/components/schemas/CatalogEnrichment"},"driverDirectory":{"$ref":"#/components/schemas/CatalogDrivers"},"vehicleProfiles":{"type":"object","properties":{"releaseStatus":{"type":"string"},"retrieval":{"type":"string","const":"stored"},"authorization":{"type":"string"},"selection":{"type":"string","const":"approved_source_vehicle_ids"},"query":{"type":"string"},"maxPageSize":{"type":"integer","const":100},"responseByteLimit":{"type":"integer","const":4194304},"visibility":{"type":"string"},"groupRelationships":{"type":"string"},"gaps":{"type":"array","items":{"type":"string"}}},"required":["releaseStatus","retrieval","authorization","selection","query","maxPageSize","responseByteLimit","visibility","groupRelationships","gaps"]},"tripHistory":{"type":"object","properties":{"releaseStatus":{"type":"string"},"retrieval":{"type":"string","const":"stored"},"authorization":{"type":"string"},"units":{"type":"object","properties":{"distance":{"type":"string","const":"kilometers"},"duration":{"type":"string","const":"milliseconds"}},"required":["distance","duration"]},"maxPageSize":{"type":"integer","const":100},"maxFilterIds":{"type":"integer","const":50},"responseByteLimit":{"type":"integer","const":4194304},"coverage":{"type":"string"},"gaps":{"type":"array","items":{"type":"string"}}},"required":["releaseStatus","retrieval","authorization","units","maxPageSize","maxFilterIds","responseByteLimit","coverage","gaps"]},"groupInventory":{"$ref":"#/components/schemas/GroupInventoryCapability"},"groupDirectory":{"$ref":"#/components/schemas/CatalogGroupDirectory"},"vehicleMetadata":{"type":"object","properties":{"releaseStatus":{"type":"string"},"fields":{"type":"array","items":{"type":"string"}},"enablement":{"type":"string"},"availability":{"type":"string"},"interpretation":{"type":"string"}},"required":["releaseStatus","fields","enablement","availability","interpretation"]}},"required":["apiVersion","catalogVersion","fields","endpoints","roadmap","enrichment","driverDirectory","tripHistory","vehicleProfiles","vehicleMetadata","groupInventory","groupDirectory"]},"locationStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180}},"required":["latitude","longitude"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"odometerStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"meters":{"type":"number","minimum":0}},"required":["meters"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"engineHoursStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"seconds":{"type":"number","minimum":0}},"required":["seconds"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"totalIdleTimeStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"seconds":{"type":"number","minimum":0}},"required":["seconds"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"engineStateStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"state":{"type":"string","enum":["on","off","idle"]}},"required":["state"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"speedStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"value":{"type":"number","minimum":0}},"required":["value"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"headingStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"value":{"type":"number","minimum":0,"maximum":360}},"required":["value"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"fuelPercentStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"value":{"type":"number","minimum":0,"maximum":100}},"required":["value"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"batteryVoltageStatus":{"type":"object","properties":{"status":{"type":"string","enum":["available","stale","missing"]},"reading":{"anyOf":[{"type":"object","properties":{"value":{"type":"object","properties":{"value":{"type":"number","minimum":0}},"required":["value"]},"source":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"fetchedAt":{"type":"string","format":"date-time"},"units":{"$ref":"#/components/schemas/UnitConversion"}},"required":["value","source","observedAt","fetchedAt"]},{"type":"null"}]},"fallback":{"type":"boolean"}},"required":["status","reading"]},"Telemetry":{"type":"object","properties":{"vehicleId":{"type":"string"},"location":{"$ref":"#/components/schemas/locationStatus"},"odometer":{"$ref":"#/components/schemas/odometerStatus"},"engineHours":{"$ref":"#/components/schemas/engineHoursStatus"},"totalIdleTime":{"$ref":"#/components/schemas/totalIdleTimeStatus"},"speed":{"$ref":"#/components/schemas/speedStatus"},"heading":{"$ref":"#/components/schemas/headingStatus"},"fuelPercent":{"$ref":"#/components/schemas/fuelPercentStatus"},"batteryVoltage":{"$ref":"#/components/schemas/batteryVoltageStatus"},"engineState":{"$ref":"#/components/schemas/engineStateStatus"},"faultsObservedAt":{"type":["string","null"],"format":"date-time"},"refreshStatus":{"type":"string","enum":["fetched","no_new_odometer","failed"]}},"required":["vehicleId","location","odometer"]},"FleetLocations":{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","properties":{"vehicleId":{"type":"string"},"location":{"$ref":"#/components/schemas/locationStatus"}},"required":["vehicleId","location"]}},"nextCursor":{"type":["string","null"]},"retrieval":{"type":"string","const":"stored"}},"required":["locations","nextCursor","retrieval"]},"Sync":{"type":"object","additionalProperties":false,"required":["id","status","requestedAt"],"properties":{"id":{"type":"string","pattern":"^sync_[0-9A-HJKMNP-TV-Z]{26}$"},"status":{"type":"string","enum":["requested","in_progress","completed","failed"]},"requestedAt":{"type":"string","format":"date-time"},"startFrom":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"attempts":{"type":"integer","minimum":1},"progress":{"type":"number","minimum":0,"maximum":100},"failureReason":{"type":"string"},"issues":{"type":"array","items":{"type":"string"},"maxItems":0,"description":"Empty in this increment; expanded provider issues remain pending implementation."},"providerRequests":{"type":"array","items":{"type":"string","enum":["historical_files","provision_credentials"]},"maxItems":0,"description":"Nonempty supplier workflows are rejected at admission in this increment."}}},"SyncPage":{"type":"object","additionalProperties":false,"required":["results"],"properties":{"results":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/Sync"}},"next":{"type":"string","pattern":"^sync_cur_[a-f0-9]{32}$"}}},"SyncControl":{"type":"object","additionalProperties":false,"required":["id","message"],"properties":{"id":{"type":"string","pattern":"^sync_[0-9A-HJKMNP-TV-Z]{26}$"},"message":{"type":"string","enum":["Sync retry requested","Sync cancellation requested"]}}},"SyncRequest":{"type":"object","additionalProperties":false,"properties":{"startFrom":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"days":{"type":"number","minimum":0},"providerRequests":{"type":"array","uniqueItems":true,"maxItems":2,"items":{"type":"string","enum":["historical_files","provision_credentials"]}}},"not":{"required":["startFrom","days"]}}}},"paths":{"/v1/syncs":{"post":{"operationId":"post__v1_syncs","summary":"Request a sync of the complete configured approved selection","tags":["Synchronization"],"security":[{"applicationSecret":[]}],"parameters":[{"name":"Connection-Token","in":"header","required":true,"schema":{"type":"string","pattern":"^con_tkn_[A-Za-z0-9_-]{43}$"},"description":"Application-scoped connection credential. Keep server-side."}],"responses":{"201":{"description":"Request a sync of the complete configured approved selection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sync"}}}},"400":{"description":"Invalid body, selector, query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid application credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Connection/operation/history permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Sync unavailable to this application","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Required configuration, data domain, supplier workflow or bounded plan unavailable; another sync or operator recovery may be active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Gate disabled or service evidence unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncRequest"}}}},"description":"Review-only, default off. Application and Connection-Token authority is checked inside each database transaction. This increment covers configured, explicitly approved vehicles, vehicle memberships and trips; it does not synchronize all Terminal data domains or discover an entire fleet. Unsupported required work is rejected atomically. Controls accept an empty body only."},"get":{"operationId":"get__v1_syncs","summary":"List this application's sync history for the authorized connection","tags":["Synchronization"],"security":[{"applicationSecret":[]}],"parameters":[{"name":"Connection-Token","in":"header","required":true,"schema":{"type":"string","pattern":"^con_tkn_[A-Za-z0-9_-]{43}$"},"description":"Application-scoped connection credential. Keep server-side."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"cursor","in":"query","schema":{"type":"string","pattern":"^sync_cur_[a-f0-9]{32}$"},"description":"Opaque keyset continuation; retain status and expansion. Expires after 15 minutes or authority changes."},{"name":"status","in":"query","schema":{"type":"string","enum":["requested","in_progress","completed","failed"]}},{"name":"expand","in":"query","schema":{"type":"string","enum":["issues"]}}],"responses":{"200":{"description":"List this application's sync history for the authorized connection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncPage"}}}},"400":{"description":"Invalid body, selector, query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid application credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Connection/operation/history permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Sync unavailable to this application","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Cursor expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Gate disabled or service evidence unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Review-only, default off. Application and Connection-Token authority is checked inside each database transaction. This increment covers configured, explicitly approved vehicles, vehicle memberships and trips; it does not synchronize all Terminal data domains or discover an entire fleet. Unsupported required work is rejected atomically. Controls accept an empty body only."}},"/v1/syncs/{id}":{"get":{"operationId":"get__v1_syncs_id_","summary":"Read sync progress and committed completion","tags":["Synchronization"],"security":[{"applicationSecret":[]}],"parameters":[{"name":"Connection-Token","in":"header","required":true,"schema":{"type":"string","pattern":"^con_tkn_[A-Za-z0-9_-]{43}$"},"description":"Application-scoped connection credential. Keep server-side."},{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sync_[0-9A-HJKMNP-TV-Z]{26}$"}},{"name":"expand","in":"query","schema":{"type":"string","enum":["issues"]}}],"responses":{"200":{"description":"Read sync progress and committed completion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sync"}}}},"400":{"description":"Invalid body, selector, query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid application credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Connection/operation/history permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Sync unavailable to this application","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Gate disabled or service evidence unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Review-only, default off. Application and Connection-Token authority is checked inside each database transaction. This increment covers configured, explicitly approved vehicles, vehicle memberships and trips; it does not synchronize all Terminal data domains or discover an entire fleet. Unsupported required work is rejected atomically. Controls accept an empty body only."}},"/v1/syncs/{id}/retry":{"post":{"operationId":"post__v1_syncs_id_retry","summary":"Retry the original frozen sync plan with fresh ownership","tags":["Synchronization"],"security":[{"applicationSecret":[]}],"parameters":[{"name":"Connection-Token","in":"header","required":true,"schema":{"type":"string","pattern":"^con_tkn_[A-Za-z0-9_-]{43}$"},"description":"Application-scoped connection credential. Keep server-side."},{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sync_[0-9A-HJKMNP-TV-Z]{26}$"}}],"responses":{"200":{"description":"Retry the original frozen sync plan with fresh ownership","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncControl"}}}},"400":{"description":"Invalid body, selector, query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid application credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Connection/operation/history permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Sync unavailable to this application","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Sync cannot be retried or cancelled in its current state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Gate disabled or service evidence unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Review-only, default off. Application and Connection-Token authority is checked inside each database transaction. This increment covers configured, explicitly approved vehicles, vehicle memberships and trips; it does not synchronize all Terminal data domains or discover an entire fleet. Unsupported required work is rejected atomically. Controls accept an empty body only."}},"/v1/syncs/{id}/cancel":{"post":{"operationId":"post__v1_syncs_id_cancel","summary":"Cancel logical work without prematurely freeing supplier capacity","tags":["Synchronization"],"security":[{"applicationSecret":[]}],"parameters":[{"name":"Connection-Token","in":"header","required":true,"schema":{"type":"string","pattern":"^con_tkn_[A-Za-z0-9_-]{43}$"},"description":"Application-scoped connection credential. Keep server-side."},{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^sync_[0-9A-HJKMNP-TV-Z]{26}$"}}],"responses":{"200":{"description":"Cancel logical work without prematurely freeing supplier capacity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncControl"}}}},"400":{"description":"Invalid body, selector, query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid application credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Connection/operation/history permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Sync unavailable to this application","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Sync cannot be retried or cancelled in its current state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Gate disabled or service evidence unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"description":"Review-only, default off. Application and Connection-Token authority is checked inside each database transaction. This increment covers configured, explicitly approved vehicles, vehicle memberships and trips; it does not synchronize all Terminal data domains or discover an entire fleet. Unsupported required work is rejected atomically. Controls accept an empty body only."}},"/v1/connections/{id}/trips":{"get":{"operationId":"get__v1_connections_id_trips","summary":"Stored completed trips with normalized references and explicit units","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100},"description":"Maximum stored trips per page. Lower limit or omit driver expansion for a smaller response."},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Keep filters/expansion fixed. Publication, consent, driver grants/snapshot or conservative relationship changes expire it (410). Bound to this consumer key."},{"name":"modifiedAfter","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive bound; RFC3339 seconds with at most6 fractional digits. modified bounds include conservative relationship/permission changes, not provider update time."},{"name":"modifiedBefore","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive bound; RFC3339 seconds with at most6 fractional digits. modified bounds include conservative relationship/permission changes, not provider update time."},{"name":"startedAfter","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive bound; RFC3339 seconds with at most6 fractional digits. modified bounds include conservative relationship/permission changes, not provider update time."},{"name":"startedBefore","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive bound; RFC3339 seconds with at most6 fractional digits. modified bounds include conservative relationship/permission changes, not provider update time."},{"name":"endedAfter","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive bound; RFC3339 seconds with at most6 fractional digits. modified bounds include conservative relationship/permission changes, not provider update time."},{"name":"endedBefore","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive bound; RFC3339 seconds with at most6 fractional digits. modified bounds include conservative relationship/permission changes, not provider update time."},{"name":"vehicleIds","in":"query","schema":{"type":"string","maxLength":1600},"description":"Comma-separated unique normalized vcl_ IDs, at most50. Driver filters cannot probe unauthorized/unresolved identities."},{"name":"driverIds","in":"query","schema":{"type":"string","maxLength":1600},"description":"Comma-separated unique normalized drv_ IDs, at most50. Driver filters cannot probe unauthorized/unresolved identities."},{"name":"expand","in":"query","schema":{"type":"string","enum":["driver","vehicle","driver,vehicle","vehicle,driver"]},"description":"Expand current independently authorized stored driver/vehicle profiles. Missing, unauthorized or filter-hidden vehicle profiles retain the normalized vehicle ID; expansion grants no new access. Expanded vehicles contain the same current permissioned directory group IDs/availability as direct vehicle reads. This is one-level expansion; group objects are not nested here."},{"name":"raw","in":"query","schema":{"type":"boolean","default":false},"description":"true returns409: original raw access and physical deletion evidence are not implemented."},{"name":"deleted","in":"query","schema":{"type":"boolean","default":false},"description":"true returns409: original raw access and physical deletion evidence are not implemented."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Stored completed trips with normalized references and explicit units","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TripPage"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Requested raw/deletion unavailable, or trip detail pending","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Current consent/publication/driver/relationship cursor expired; restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Trip response exceeds4MiB; lower limit or omit expansion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/trips/{tripId}":{"get":{"operationId":"get__v1_connections_id_trips_tripId_","summary":"Read one authorized stored trip","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"tripId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/TripId"}},{"name":"expand","in":"query","schema":{"type":"string","enum":["driver","vehicle","driver,vehicle","vehicle,driver"]},"description":"Expand current independently authorized stored driver/vehicle profiles. Missing, unauthorized or filter-hidden vehicle profiles retain the normalized vehicle ID; expansion grants no new access. Expanded vehicles contain the same current permissioned directory group IDs/availability as direct vehicle reads. This is one-level expansion; group objects are not nested here."},{"name":"raw","in":"query","schema":{"type":"boolean","default":false},"description":"true returns409: original raw access and physical deletion evidence are not implemented."},{"name":"deleted","in":"query","schema":{"type":"boolean","default":false},"description":"true returns409: original raw access and physical deletion evidence are not implemented."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Read one authorized stored trip","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Trip"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Requested raw/deletion unavailable, or trip detail pending","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Trip response exceeds4MiB; lower limit or omit expansion","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/drivers":{"get":{"operationId":"get__v1_connections_id_drivers","summary":"Stored driver directory with separate consent and read access","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100},"description":"Page size, from 1 to 100. Duplicate query parameters are rejected."},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque next cursor; keep time/expansion filters unchanged. Snapshot or approved-scope changes expire it."},{"name":"modifiedAfter","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive ingestion change-time bound, explicit RFC3339 seconds with offset and at most six fractional digits."},{"name":"modifiedBefore","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive ingestion change-time bound; must be after modifiedAfter."},{"name":"raw","in":"query","schema":{"type":"boolean","default":false},"description":"Raw supplier data is unavailable. raw=true returns 409."},{"name":"deleted","in":"query","schema":{"type":"boolean","default":false},"description":"No physical-deletion evidence. deleted=true returns 409; absence is not deletion."},{"name":"expand","in":"query","schema":{"type":"string","enum":["groups"]},"description":"Expand stored driver groups in the requested groupScope. Directory expansion uses the same IDs/objects as groups?scope=directory and requires both read grants. No supplier calls; check coverage and freshness."},{"name":"groupScope","in":"query","schema":{"type":"string","enum":["directory"]},"description":"On driver reads, resolve groups through the full stored directory. Requires both current driver and group-directory grants for matching verified accounts; otherwise 404. Omit for approved-ID relationships. Keep unchanged while paging."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Stored driver directory with separate consent and read access","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DriverDirectory"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Raw/deletion functionality unavailable; pending lists return 200 with status=pending","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Driver or group relationship cursor expired; restart pagination","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Expanded driver/group response exceeds 4 MiB; lower the list limit or omit expand=groups","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/groups":{"get":{"operationId":"get__v1_connections_id_groups","summary":"Stored group directories or approved groups with parent relationships","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"scope","in":"query","schema":{"type":"string","enum":["directory"]},"description":"directory reads the stored credential-visible group directory with separate account-group consent and read grant. Omit on lists for existing approved-ID scope. Required on group detail.","required":false},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100},"description":"Page size, from 1 to 100. Duplicate query parameters are rejected."},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque next cursor; keep time/expansion filters unchanged. Snapshot or approved-scope changes expire it."},{"name":"expand","in":"query","schema":{"type":"string","enum":["parent"]},"description":"Expand one parent level within the same authorized stored snapshot; further parents remain IDs."},{"name":"modifiedAfter","in":"query","schema":{"type":"string","format":"date-time","maxLength":64},"description":"Exclusive lower bound on stored metadata.modifiedAt. Fractional precision beyond microseconds is accepted in approved-ID mode with at most 64 characters; directory mode accepts at most 40 characters and 6 fractional digits. Not source time."},{"name":"modifiedBefore","in":"query","schema":{"type":"string","format":"date-time","maxLength":64},"description":"Exclusive upper bound on stored metadata.modifiedAt, after modifiedAfter. Approved-ID mode accepts at most 64 characters; directory mode accepts at most 40 characters and 6 fractional digits."},{"name":"deleted","in":"query","schema":{"type":"boolean","default":false},"description":"No physical-deletion evidence or tombstones are available; deleted=true returns 409."},{"name":"raw","in":"query","schema":{"type":"boolean","default":false},"description":"Raw supplier data is unavailable. raw=true returns 409."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Stored group directories or approved groups with parent relationships","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupReadResponse"}}}},"400":{"description":"Invalid group query, limit, expansion, time filter or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Raw provider data or physical-deletion evidence unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Cursor publication, consent, generation or approved scope has changed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Group response exceeds 4 MiB; lower limit or omit expand=parent when requested","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/groups/{groupId}":{"get":{"operationId":"get__v1_connections_id_groups_groupId_","summary":"Read one stored directory group by stable normalized ID","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"groupId","in":"path","required":true,"schema":{"type":"string","pattern":"^group_[0-7][0-9A-HJKMNP-TV-Z]{25}$"}},{"name":"scope","in":"query","schema":{"type":"string","enum":["directory"]},"description":"directory reads the stored credential-visible group directory with separate account-group consent and read grant. Omit on lists for existing approved-ID scope. Required on group detail.","required":true},{"name":"raw","in":"query","schema":{"type":"boolean","default":false},"description":"Raw supplier data is unavailable. raw=true returns 409."},{"name":"expand","in":"query","schema":{"type":"string","enum":["parent"]},"description":"Expand one parent level within the same authorized stored snapshot; further parents remain IDs."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Read one stored directory group by stable normalized ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupDirectoryResult"}}}},"400":{"description":"Invalid group query, limit, expansion, time filter or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Raw provider data unavailable or group directory pending","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/drivers/{driverId}":{"get":{"operationId":"get__v1_connections_id_drivers_driverId_","summary":"Read one stored driver by stable normalized ID","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"driverId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/DriverId"}},{"name":"raw","in":"query","schema":{"type":"boolean","default":false},"description":"Raw supplier data is unavailable. raw=true returns 409."},{"name":"expand","in":"query","schema":{"type":"string","enum":["groups"]},"description":"Expand stored driver groups in the requested groupScope. Directory expansion uses the same IDs/objects as groups?scope=directory and requires both read grants. No supplier calls; check coverage and freshness."},{"name":"groupScope","in":"query","schema":{"type":"string","enum":["directory"]},"description":"On driver reads, resolve groups through the full stored directory. Requires both current driver and group-directory grants for matching verified accounts; otherwise 404. Omit for approved-ID relationships. Keep unchanged while paging."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Read one stored driver by stable normalized ID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DriverResult"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Driver directory pending, or raw functionality unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Expanded driver/group response exceeds 4 MiB; omit expand=groups to use group references","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/metadata":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_metadata","summary":"Stored provider vehicle identity, status and group references","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Stored provider vehicle identity, status and group references","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleMetadataResponse"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/profile":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_profile","summary":"Cached vehicle identity, images, specifications and factory build","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Cached vehicle identity, images, specifications and factory build","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleProfile"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/identity":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_identity","summary":"Cached vehicle identity with source and availability","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Cached vehicle identity with source and availability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentitySection"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/images":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_images","summary":"Cached vehicle images with source and availability","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Cached vehicle images with source and availability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImagesSection"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/specifications":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_specifications","summary":"Cached vehicle specifications with source and availability","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Cached vehicle specifications with source and availability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpecificationsSection"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/build":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_build","summary":"Cached vehicle build with source and availability","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Cached vehicle build with source and availability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuildSection"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/locations":{"get":{"operationId":"get__v1_connections_id_locations","summary":"Stored fleet locations with per-asset freshness, 100 per page","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"after","in":"query","schema":{"type":"string"},"description":"Opaque provider vehicle ID from nextCursor. Keep the same time window when paging."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Stored fleet locations with per-asset freshness, 100 per page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetLocations"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/catalog":{"get":{"operationId":"get__v1_catalog","summary":"Normalized fields, units and API operations","tags":["Connections and fleet"],"parameters":[],"security":[],"responses":{"200":{"description":"Normalized fields, units and API operations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}}}},"/v1/connections/{id}":{"get":{"operationId":"get__v1_connections_id_","summary":"Connection identity and collection health","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Connection identity and collection health","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Connection"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/capabilities":{"get":{"operationId":"get__v1_connections_id_capabilities","summary":"Provider capabilities and adapter version","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Provider capabilities and adapter version","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capabilities"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/connect-sessions":{"post":{"operationId":"post__v1_connections_id_connect_sessions","summary":"Create a ten-minute provider consent link","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Create a ten-minute provider consent link","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectSession"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"pause_connection_before_connect or geotab_account_setup_required: pause the approved connection and prepare its fixed provider account before issuing a link","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Refresh or session rate limit; inspect Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds before retry"}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/connect-sessions/{sessionId}":{"get":{"operationId":"get__v1_connections_id_connect_sessions_sessionId_","summary":"Read the initiating consumer's session status","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Read the initiating consumer's session status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionStatus"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/disconnect":{"post":{"operationId":"post__v1_connections_id_disconnect","summary":"Disable local access and collection","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Disable local access and collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Disconnect"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles":{"get":{"operationId":"get__v1_connections_id_vehicles","summary":"List core assets or independently authorized normalized vehicle profiles","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"after","in":"query","schema":{"type":"string"},"description":"Opaque provider vehicle ID from nextCursor. Keep the same time window when paging."},{"name":"scope","in":"query","schema":{"type":"string","enum":["directory"]},"description":"directory selects independently authorized account-bound normalized profiles; omitted on lists retains core assets"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":100},"description":"Stored normalized profiles only; no provider call"},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque key/permission/publication/revision/filter-bound cursor; restart after 410"},{"name":"modifiedAfter","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive service-observed change bound, including conservative permission/relationship changes; not upstream update time"},{"name":"modifiedBefore","in":"query","schema":{"type":"string","format":"date-time","maxLength":40,"pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,6})?(?:Z|[+-]\\d{2}:\\d{2})$"},"description":"Exclusive service-observed change bound, including conservative permission/relationship changes; not upstream update time"},{"name":"hidden","in":"query","schema":{"type":"boolean","default":false},"description":"Include authorized profiles hidden by current configured include/exclude/status filters; does not grant new access"},{"name":"raw","in":"query","schema":{"type":"boolean","default":false},"description":"Requested true raw/deleted returns409 until independently implemented and authorized"},{"name":"deleted","in":"query","schema":{"type":"boolean","default":false},"description":"Requested true raw/deleted returns409 until independently implemented and authorized"},{"name":"expand","in":"query","schema":{"type":"string","enum":["groups","devices","groups,devices","devices,groups"]},"description":"groups resolves stored normalized group objects under current profile/membership/directory grants; unavailable relationship access or device expansion returns409"}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"List core assets or independently authorized normalized vehicle profiles","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleReadResponse"}}}},"400":{"description":"Invalid directory query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Profile detail pending, raw/deletion/group/device expansion unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Permission/publication/filter cursor expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Profile response exceeds4MiB; lower list limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_","summary":"Read one current authorized normalized vehicle profile","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"$ref":"#/components/schemas/TripVehicleId"}},{"name":"scope","in":"query","required":true,"schema":{"type":"string","enum":["directory"]},"description":"directory selects independently authorized account-bound normalized profiles; omitted on lists retains core assets"},{"name":"hidden","in":"query","schema":{"type":"boolean","default":false},"description":"Include authorized profiles hidden by current configured include/exclude/status filters; does not grant new access"},{"name":"raw","in":"query","schema":{"type":"boolean","default":false},"description":"Requested true raw/deleted returns409 until independently implemented and authorized"},{"name":"deleted","in":"query","schema":{"type":"boolean","default":false},"description":"Requested true raw/deleted returns409 until independently implemented and authorized"},{"name":"expand","in":"query","schema":{"type":"string","enum":["groups","devices","groups,devices","devices,groups"]},"description":"groups resolves stored normalized group objects under current profile/membership/directory grants; unavailable relationship access or device expansion returns409"}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Read one current authorized normalized vehicle profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleEntity"}}}},"400":{"description":"Invalid directory query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Profile detail pending, raw/deletion/group/device expansion unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Profile response exceeds4MiB; lower list limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/telemetry":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_telemetry","summary":"Latest readings with source, time and freshness","tags":["Telemetry"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Latest readings with source, time and freshness","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Telemetry"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/refresh":{"post":{"operationId":"post__v1_connections_id_vehicles_vehicleId_refresh","summary":"Fetch latest provider readings; return a labeled fallback on failure","tags":["Telemetry"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Fetch latest provider readings; return a labeled fallback on failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Telemetry"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Refresh or session rate limit; inspect Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"string"},"description":"Seconds before retry"}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/faults":{"get":{"operationId":"get__v1_connections_id_faults","summary":"Active fault occurrences, 100 per page","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"after","in":"query","schema":{"type":"string","format":"uuid"},"description":"Fault occurrence cursor from nextCursor."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Active fault occurrences, 100 per page","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Faults"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/fault-events":{"get":{"operationId":"get__v1_connections_id_fault_events","summary":"Opened/cleared events with durable cursor","tags":["Connections and fleet"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"after","in":"query","schema":{"type":"string","pattern":"^[0-9]{1,18}$","default":"0"},"description":"Opaque sequence cursor. History pages follow ingestion order, not source-time order. Keep all filters fixed."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Opened/cleared events with durable cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FaultEvents"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/history":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_history","summary":"Stored readings, 100 per page; up to 31 days per query","tags":["Telemetry"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"RFC3339 with offset. History: inclusive; counters use only samples within the window. No interpolation."},{"name":"endTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"After startTime and no later than now. History: exclusive. Counter summaries permit a boundary sample at endTime."},{"name":"after","in":"query","schema":{"type":"string","pattern":"^[0-9]{1,18}$","default":"0"},"description":"Opaque sequence cursor. History pages follow ingestion order, not source-time order. Keep all filters fixed."},{"name":"metric","in":"query","schema":{"type":"string","enum":["location","odometer","engineHours","totalIdleTime","speed","heading","fuelPercent","batteryVoltage","engineState"]},"description":"Optional history field filter."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Stored readings, 100 per page; up to 31 days per query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/History"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/utilization":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_utilization","summary":"Observed engine runtime versus not running, distance and idle time; up to 7 days","tags":["Usage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"RFC3339 with offset. History: inclusive; counters use only samples within the window. No interpolation."},{"name":"endTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"After startTime and no later than now. History: exclusive. Counter summaries permit a boundary sample at endTime."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Observed engine runtime versus not running, distance and idle time; up to 7 days","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Utilization"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Requested utilization has more than 10,000 readings; narrow the window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/distance":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_distance","summary":"Distance accumulated across valid odometer intervals","tags":["Usage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"RFC3339 with offset. History: inclusive; counters use only samples within the window. No interpolation."},{"name":"endTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"After startTime and no later than now. History: exclusive. Counter summaries permit a boundary sample at endTime."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Distance accumulated across valid odometer intervals","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounterReport"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Requested utilization has more than 10,000 readings; narrow the window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/engine-hours":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_engine_hours","summary":"Engine runtime accumulated across valid counter intervals","tags":["Usage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"RFC3339 with offset. History: inclusive; counters use only samples within the window. No interpolation."},{"name":"endTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"After startTime and no later than now. History: exclusive. Counter summaries permit a boundary sample at endTime."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Engine runtime accumulated across valid counter intervals","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounterReport"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Requested utilization has more than 10,000 readings; narrow the window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/vehicles/{vehicleId}/idling":{"get":{"operationId":"get__v1_connections_id_vehicles_vehicleId_idling","summary":"Idle duration from supported cumulative counters","tags":["Usage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"vehicleId","in":"path","required":true,"schema":{"type":"string"}},{"name":"startTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"RFC3339 with offset. History: inclusive; counters use only samples within the window. No interpolation."},{"name":"endTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"After startTime and no later than now. History: exclusive. Counter summaries permit a boundary sample at endTime."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Idle duration from supported cumulative counters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounterReport"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Requested utilization has more than 10,000 readings; narrow the window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/connections/{id}/utilization":{"get":{"operationId":"get__v1_connections_id_utilization","summary":"Per-vehicle fleet summaries, 10 vehicles per page; up to 7 days","tags":["Usage"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"startTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"RFC3339 with offset. History: inclusive; counters use only samples within the window. No interpolation."},{"name":"endTime","in":"query","required":true,"schema":{"type":"string","format":"date-time"},"description":"After startTime and no later than now. History: exclusive. Counter summaries permit a boundary sample at endTime."},{"name":"after","in":"query","schema":{"type":"string"},"description":"Opaque provider vehicle ID from nextCursor. Keep the same time window when paging."}],"security":[{"consumerKey":[]}],"responses":{"200":{"description":"Per-vehicle fleet summaries, 10 vehicles per page; up to 7 days","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetUtilization"}}}},"400":{"description":"Invalid time window, metric or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Consumer authentication denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Resource missing or connection access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Requested utilization has more than 10,000 readings; narrow the window","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Service or database unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}