Automile ResourceOwnerTrip3V2 API
The ResourceOwnerTrip3V2 API from Automile — 15 operation(s) for resourceownertrip3v2.
The ResourceOwnerTrip3V2 API from Automile — 15 operation(s) for resourceownertrip3v2.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/automile-resourceownertrip3v2-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: Automile ClientApi Resource Owner Trip3 V2 API
version: v1
servers:
- url: https://api.automile.com/
tags:
- name: ResourceOwnerTrip3V2
paths:
/v1/resourceowner/trips3:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get all trips that the user has access to
description: Only returns trips that the user have access to
operationId: GetResourceOwnerTrips2
parameters:
- in: query
name: lastNumberOfDays
description: Optional enter last number of days to get trips for
schema:
type: integer
format: int32
- in: query
name: vehicleId
description: Optional vehicle id to get trips for
schema:
type: integer
format: int32
- in: query
name: synchronized
description: Optional include synchronized trips (defaults to true)
schema:
type: boolean
default: true
- in: query
name: fromUtc
description: Retrieve trips from this date. (Can't be used if lastNumberOfDays is specified)
schema:
type: string
format: date-time
- in: query
name: toUtc
description: Retrieve trips to this date. (Can't be used if lastNumberOfDays is specified)
schema:
type: string
format: date-time
responses:
'200':
description: Success
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Trip2Model'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Trip2Model'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Trip2Model'
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the details about the trip
description: Only trips that are associated with the vehicles that user has relationships with are allowed.
operationId: GetResourceOwnerTripDetail2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The trip details are returned
content:
text/plain:
schema:
$ref: '#/components/schemas/Trip2DetailModel'
application/json:
schema:
$ref: '#/components/schemas/Trip2DetailModel'
text/json:
schema:
$ref: '#/components/schemas/Trip2DetailModel'
'403':
description: Request is forbidden, meaning you don't have access to this trip
'500':
description: Internal server error
security:
- oauth2: []
put:
tags:
- ResourceOwnerTrip3V2
summary: Updates the given trip with a trip type (category) and trip tags
description: This operation would only update the trip type and trip tags if authorized for this trip.
operationId: EditResourceOwnerTrip2
parameters:
- in: path
name: tripId
description: The trip id to update
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The trip was saved
'500':
description: Internal server error
security:
- oauth2: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Trip2EditModel'
text/json:
schema:
$ref: '#/components/schemas/Trip2EditModel'
application/*+json:
schema:
$ref: '#/components/schemas/Trip2EditModel'
description: The triptype and triptags to update
/v1/resourceowner/trips3/{tripId}/geostartend:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the trip start and stop geo locations
description: Only trips that are associated with the vehicles that user has relationships with are allowed.
operationId: GetResourceOwnerGeoStartStop2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The Start and stop geo locations details are returned
content:
text/plain:
schema:
$ref: '#/components/schemas/Trip2StartEndGeoModel'
application/json:
schema:
$ref: '#/components/schemas/Trip2StartEndGeoModel'
text/json:
schema:
$ref: '#/components/schemas/Trip2StartEndGeoModel'
'403':
description: Request is forbidden, meaning you don't have access to this trip
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/speed:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the vehicle speed if it's reported by the vehicle
description: This is a quick method, instead of retrieving raw data with the pid operation. Is reported in km/h.
operationId: GetResourceOwnerTripSpeed2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The vehicle speeds are returned
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/VehicleSpeed2Model'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/VehicleSpeed2Model'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/VehicleSpeed2Model'
'501':
description: Not implemented, meaning the PID is not supported or is not recorded by the vehicle
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/rpm:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the vehicle engine rpm if it's reported by the vehicle
description: This is a quick method, instead of retrieving raw data with the pid operation.
operationId: GetResourceOwnerTripRPM2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The vehicle engine rpm are returned
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/RPM2Model'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RPM2Model'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/RPM2Model'
'501':
description: Not implemented, meaning the PID is not supported or is not recorded by the vehicle
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/ambienttemperature:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the vehicle ambient (outside) temperature if it's reported by the vehiclee
description: This is a quick method, instead of retrieving raw data with the pid operation. The result is in celsius.
operationId: GetResourceOwnerTripAmbientTemperature2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: Te list of all ambient temperatures are returned
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/AmbientAirTemperatureModel'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/AmbientAirTemperatureModel'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/AmbientAirTemperatureModel'
'501':
description: Not implemented, meaning the PID is not supported or is not recorded by the vehicle
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/fuellevelinput:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the vehicle current fuel level if it's reported by the vehicle
description: This is a quick method, instead of retrieving raw data with the pid operation. The result is in percentage of total 100
operationId: GetResourceOwnerTripFuelLevelInput2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The recorded fuel level details are returned
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/FuelLevelInput2Model'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FuelLevelInput2Model'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/FuelLevelInput2Model'
'501':
description: Not implemented, meaning the PID is not supported or is not recorded by the vehicle
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/enginecoolanttemperature:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the engine coolant temperature if it's reported by the vehicle
description: This is a quick method, instead of retrieving raw data with the pid operation
operationId: GetResourceOwnerTripEngineCoolantTemperature2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The engine coolant temperature are returned
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/EngineCoolantTemperature2Model'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/EngineCoolantTemperature2Model'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/EngineCoolantTemperature2Model'
'501':
description: Not implemented, meaning the PID is not supported or is not recorded by the vehicle
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/pid/{pidId}:
get:
tags:
- ResourceOwnerTrip3V2
summary: This will get the raw PID data if the vehicle has reported that it is being recorded
description: The data array will contain a sub-array of integers representing the raw data
operationId: GetResourceOwnerTripPid2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
- in: path
name: pidId
description: The PID id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: ThePID data are returned
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/PID2Model'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PID2Model'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/PID2Model'
'501':
description: Not implemented, meaning the PID is not supported or is not recorded by the vehicle
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/geo:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the gps locations for the vehicle, includes position and heading
description: This operation would require compression enabled by the client.
operationId: GetResourceOwnerTripGeo2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
- in: query
name: everyNthRecord
description: Optional if you wish to limit to n:th number of records
schema:
type: integer
format: int32
default: 1
- in: query
name: snapToRoad
description: ''
schema:
type: boolean
default: true
responses:
'200':
description: The Geo data are returned
content:
text/plain:
schema:
type: array
items:
$ref: '#/components/schemas/Trip2GeoModel'
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Trip2GeoModel'
text/json:
schema:
type: array
items:
$ref: '#/components/schemas/Trip2GeoModel'
'501':
description: Not implemented, meaning the PID is not supported or is not recorded by the vehicle
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/googleurltostaticmapencodedpolyline:
get:
tags:
- ResourceOwnerTrip3V2
summary: Gets Google static map URL with the trip route as a polyline
operationId: GetGoogleurlToStaticMapEncodedPolyline2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
- in: query
name: height
description: Height of the map
schema:
type: integer
format: int32
- in: query
name: width
description: Width of the map
schema:
type: integer
format: int32
responses:
'200':
description: The Google Map Url are returned
content:
text/plain:
schema:
type: string
application/json:
schema:
type: string
text/json:
schema:
type: string
'400':
description: Bad request, this operation explicitly require gzip compression by the client
'501':
description: Not implemented, meaning the PID is not supported or is not recorded by the vehicle
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/setdriverontrip:
put:
tags:
- ResourceOwnerTrip3V2
summary: Updates the given trip with given contactid
description: This operation would only update the driver if authorized for this trip.
operationId: SetDriverOnTrip2
parameters:
- in: query
name: tripId
description: The trip to update
schema:
type: integer
format: int32
- in: query
name: contactId
description: The contact id for the driver
schema:
type: integer
format: int32
responses:
'200':
description: The trip was saved
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/details:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the details about the trip including driving events, speeding and idling
description: Only trips that are associated with the vehicles that user has relationships with are allowed.
operationId: GetResourceOwnerTripDetailConcat2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The trip details are returned
content:
text/plain:
schema:
$ref: '#/components/schemas/TripConcatenationModel'
application/json:
schema:
$ref: '#/components/schemas/TripConcatenationModel'
text/json:
schema:
$ref: '#/components/schemas/TripConcatenationModel'
'403':
description: Request is forbidden, meaning you don't have access to this trip
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/{tripId}/advanced:
get:
tags:
- ResourceOwnerTrip3V2
summary: Get the advanced details about the trip including driving events, speeding, idling, speed and rpm data series
description: Only trips that are associated with the vehicles that user has relationships with are allowed.
operationId: GetResourceOwnerTripAdvanced2
parameters:
- in: path
name: tripId
description: The trip id
required: true
schema:
type: integer
format: int32
responses:
'200':
description: The trip advanced data are returned
content:
text/plain:
schema:
$ref: '#/components/schemas/TripConcatenationModel'
application/json:
schema:
$ref: '#/components/schemas/TripConcatenationModel'
text/json:
schema:
$ref: '#/components/schemas/TripConcatenationModel'
'403':
description: Request is forbidden, meaning you don't have access to this trip
'500':
description: Internal server error
security:
- oauth2: []
/v1/resourceowner/trips3/batch/triptype:
put:
tags:
- ResourceOwnerTrip3V2
summary: Updates a list of trip id's with the provided trip type
description: This operation only updates the trip types if authorized to all trips in list.
operationId: ResourceOwnerTrip3Controller_TripTypeBatchUpdate
responses:
'200':
description: The trips was saved
'500':
description: Internal server error
security:
- oauth2: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TripTypeBatchUpdateModel'
text/json:
schema:
$ref: '#/components/schemas/TripTypeBatchUpdateModel'
application/*+json:
schema:
$ref: '#/components/schemas/TripTypeBatchUpdateModel'
description: The trip type and trips to update
components:
schemas:
RegisteredTollModelGET:
type: object
properties:
TimestampUtc:
format: date-time
type: string
Fee:
format: double
type: number
TripId:
format: int32
type: integer
GeofenceId:
format: int32
type: integer
TollZoneId:
format: int32
type: integer
PriceAfterDiscount:
format: double
type: number
TollZoneName:
type: string
RegisteredTollId:
format: int32
type: integer
VehicleId:
format: int32
type: integer
VehicleUserFriendlyName:
type: string
VehicleMake:
type: string
VehicleModel:
type: string
VehicleNumberPlate:
type: string
DriverContactId:
format: int32
type: integer
DriverImageUrl:
type: string
DriverName:
type: string
CurrencyISO4271:
type: string
ReadOnly:
type: boolean
TripType:
format: int32
enum:
- 0
- 1
- 2
- 3
type: integer
additionalProperties: false
TripConcatenationPoint:
type: object
properties:
Latitude:
format: double
type: number
Longitude:
format: double
type: number
RecordTimeStamp:
format: date-time
type: string
RecordTimeStampEpochMs:
format: int64
type: integer
readOnly: true
Speed:
format: double
type: number
RPM:
format: double
type: number
HeadingDegress:
format: int32
type: integer
Hdop:
format: int32
type: integer
NumberOfSatellites:
format: int32
type: integer
additionalProperties: false
VehicleSpeed2Model:
type: object
properties:
SpeedKmPerHour:
format: double
type: number
RecordTimeStamp:
format: date-time
type: string
additionalProperties: false
TripConcatenationData:
type: object
properties:
RecordTimeStamp:
format: date-time
type: string
RecordTimeStampEpochMs:
format: int64
type: integer
readOnly: true
Value:
format: double
type: number
additionalProperties: false
Trip2GeoModel:
type: object
properties:
RecordTimeStamp:
format: date-time
type: string
Latitude:
format: double
type: number
Longitude:
format: double
type: number
HeadingDegrees:
format: int32
type: integer
NumberOfSatellites:
format: int32
type: integer
HDOP:
format: int32
type: integer
additionalProperties: false
TripConcatenationIdling:
type: object
properties:
Latitude:
format: double
type: number
Longitude:
format: double
type: number
RecordTimeStamp:
format: date-time
type: string
RecordTimeStampEpochMs:
format: int64
type: integer
readOnly: true
IdleInSeconds:
format: int32
type: integer
additionalProperties: false
TripConcatenationSpeedPoint:
type: object
properties:
Speed:
format: double
type: number
SpeedLimit:
format: double
type: number
Latitude:
format: double
type: number
Longitude:
format: double
type: number
RecordTimeStamp:
format: date-time
type: string
RecordTimeStampEpochMs:
format: int64
type: integer
readOnly: true
additionalProperties: false
TripConcatenationStartEndPoint:
type: object
properties:
Latitude:
format: double
type: number
Longitude:
format: double
type: number
additionalProperties: false
PID2Model:
type: object
properties:
Data:
format: byte
type: string
RecordTimeStamp:
format: date-time
type: string
Value:
format: double
type: number
additionalProperties: false
Trip2Model:
type: object
properties:
TripId:
format: int32
type: integer
TripStartDateTime:
format: date-time
type: string
TripEndDateTime:
format: date-time
type: string
DistanceKilometers:
format: double
type: number
FuelConsumptionInLiters:
format: double
type: number
TripStartFormattedAddress:
type: string
TripEndFormattedAddress:
type: string
TripStartCustomAddress:
type: string
TripEndCustomAddress:
type: string
VehicleId:
format: int32
type: integer
TripType:
format: int32
enum:
- 0
- 1
- 2
- 3
type: integer
DriverContactId:
format: int32
type: integer
HasSpeedingViolation:
type: boolean
HasIdlingEvent:
type: boolean
HasAccelerationEvent:
type: boolean
HasAccident:
type: boolean
HasTurningEvent:
type: boolean
HasBrakingEvent:
type: boolean
ParkedForMinutesUntilNextTrip:
format: int32
type: integer
HasDrivingEvents:
type: boolean
CustomCategory:
type: string
TripTags:
type: string
HideStartRoute:
type: boolean
HideEndRoute:
type: boolean
VehicleType:
format: int32
enum:
- 0
- 1
- 2
- 3
- 4
- 5
- 6
- 255
type: integer
TripApprovalStatus:
format: int32
enum:
- 0
- 1
- 2
- 3
type: integer
IsMerged:
type: boolean
HasGermanTaxRules:
type: boolean
IsLocked:
type: boolean
LockReason:
format: int32
enum:
- 0
- 1
- 2
- 4
type: integer
IsEditable:
type: boolean
TripStartCountry:
type: string
TripStartPostalCode:
type: string
TripEndCountry:
type: string
TripEndPostalCode:
type: string
additionalProperties: false
AmbientAirTemperatureModel:
description: PID70
type: object
properties:
TemperatureInCelsius:
format: double
type: number
RecordTimeStamp:
format: date-time
type: string
additionalProperties: false
TripConcatenationSpeedGroup:
type: object
properties:
SpeedGroup:
format: uuid
type: string
SpeedingForMoreThan30Seconds:
type: boolean
DistanceOfSpeeding:
format: double
type: number
DistanceInSeconds:
format: int32
type: integer
ThresholdType:
format: int32
type: integer
SpeedPoints:
type: array
items:
$ref: '#/components/schemas/TripConcatenationSpeedPoint'
additionalProperties: false
TripTypeBatchUpdateModel:
type: object
properties:
TripType:
format: int32
enum:
- 0
- 1
- 2
- 3
type: integer
CustomCategory:
type: string
TripIdList:
type: array
items:
format: int32
type: integer
additionalProperties: false
TripConcatenationSimplePoint:
type: object
properties:
Latitude:
format: double
type: number
Longitude:
format: double
type: number
RecordTimeStamp:
format: date-time
type: string
RecordTimeStampEpochMs:
format: int64
type: integer
readOnly: true
additionalProperties: false
FuelLevelInput2Model:
type: object
properties:
FuelLevelInPercentage:
format: double
type: number
RecordTimeStamp:
format: date-time
type: string
additionalProperties: false
RPM2Model:
type: object
properties:
RPMValue:
format: double
type: number
RecordTimeStamp:
format: date-time
type: string
additionalProperties: false
Trip2StartEndGeoModel:
type: object
properties:
StartLatitude:
format: double
type: number
StartLongitude:
format: double
type: number
EndLatitude:
format: double
type: number
EndLongitude:
format: double
type: number
additionalProperties: false
TripConcatenationModel:
type: object
properties:
TripId:
format: int32
type: integer
VehicleId:
format: int32
type: integer
VehicleName:
type: string
MergedFromTripIds:
type: array
items:
format: int32
type: integer
SpeedGroups:
type: array
items:
$ref: '#/components/schemas/TripConcatenationSpeedGroup'
SpeedPoints:
type: array
items:
$ref: '#/components/schemas/TripConcatenationSpeedPoint'
RawPoints:
type: array
items:
$ref: '#/components/schemas/TripConcatenationPoint'
SnappedToRoadPoints:
type: array
items:
$ref: '#/components/schemas/TripConcatenationSimplePoint'
IdlingEvents:
type: array
items:
$ref: '#/components/schemas/TripConcatenationIdling'
DrivingEvents:
type: array
items:
$ref: '#/components/schemas/TripConcatenationEvent'
SpeedData:
type: array
items:
$ref: '#/components/schemas/TripConcatenationData'
SpeedLimitData:
type: array
items:
$ref: '#/components/schemas/TripConcatenationData'
RPMData:
type: array
items:
$ref: '#/components/schemas/TripConcatenationData'
FuelRateData:
type: array
items:
$ref: '#/components/schemas/TripConcatenationData'
StartDateTime:
format: date-time
type: string
EndDateTime:
format: date-time
type: string
TripTimeZone:
format: int32
type: integer
StartFormattedAddress:
type: string
EndFormattedAddress:
type: string
StartCustomAddress:
type: string
EndCustomAddress:
type: string
Distance:
format: double
type: number
FuelConsumption:
format: double
type: number
LengthInMinutes:
format: int32
type: integer
DriverContactId:
format: int32
type: integer
DriverName:
type: string
IdleRPMAverage:
format: int32
type: integer
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/automile/refs/heads/main/openapi/automile-resourceownertrip3v2-api-openapi.yml