List trips

get

/fleetMonitoring/clientapi/v2/trips

This operation returns the list of all the trips existing for the current Oracle IoT Fleet Monitoring Application instance.

Request

Query Parameters

• expand(optional): string
  The list of fields to be expanded in the result. Use 'all' to expand all expandable fields in result.
• fields(optional): string
  The comma-separated list of fields to be shown in response. By default all response object fields will be present.
• limit(optional): integer
  The maximum number of entries to return to the end user.
• offset(optional): integer
  The number that the first record of results is starting from.
• orderBy(optional): string
  Ordering criteria for the returned trips' list.
• q(optional): string
  Query to filter trips on the app. (For more information on mongoDB query parameters refer to Using mongoDB Query Syntax.)
• since(optional): integer
  The starting point of the desired time interval, in milliseconds. The default is 0.
• totalResults(optional): boolean
  The total number of results suiting the request.
• until(optional): integer
  The finishing point of the desired time interval, in milliseconds. The default is 0.

Response

Supported Media Types

• application/json
• application/vnd.oracle.resource+json;type=collection

200 Response

Successfully processed.

Body ()

Root Schema : Trip_receive_list

Type: object

Show Source

• count: integer(int32)
• hasMore: boolean
• items: array items
• limit: integer(int32)
• links: array links
  The set of API navigation links.
• offset: integer(int32)

{
    "type":"object",
    "required":[
        "items",
        "links",
        "limit",
        "offset",
        "count",
        "hasMore"
    ],
    "properties":{
        "offset":{
            "format":"int32",
            "type":"integer"
        },
        "count":{
            "format":"int32",
            "type":"integer"
        },
        "limit":{
            "format":"int32",
            "type":"integer"
        },
        "hasMore":{
            "type":"boolean"
        },
        "links":{
            "description":"The set of API navigation links.",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "rel":{
                        "description":"Relation type",
                        "type":"string",
                        "example":"canonical"
                    },
                    "href":{
                        "description":"The target resource URI",
                        "type":"string",
                        "example":"https://iotserver/iot/api/vX/some/API/path"
                    }
                }
            }
        },
        "items":{
            "type":"array",
            "items":{
                "type":"object",
                "required":[
                    "id",
                    "name",
                    "tripTemplateId",
                    "driverId",
                    "vehicleId",
                    "vehicle",
                    "source",
                    "destination",
                    "stops",
                    "tripStatus",
                    "expectedDuration",
                    "startTime",
                    "endTime",
                    "tripLength",
                    "lastModifiedTime",
                    "totalStops",
                    "stopsClassification",
                    "tripLengthClassification",
                    "tripContext"
                ],
                "properties":{
                    "tripLength":{
                        "description":"Total length of the Trip",
                        "type":"number"
                    },
                    "lastModifiedTime":{
                        "description":"Last modified time (millisecond) ",
                        "type":"integer"
                    },
                    "totalStops":{
                        "description":"Total stops for the trip",
                        "type":"integer"
                    },
                    "destination":{
                        "$ref":"#/definitions/TripStops_receive"
                    },
                    "stopsClassification":{
                        "description":"One of [SINGLE_STOP, DUAL_STOP, TRIPLE_STOP, MULTI_STOP, NON_STOP].",
                        "type":"string"
                    },
                    "source":{
                        "$ref":"#/definitions/TripStops_receive"
                    },
                    "expectedDuration":{
                        "description":"Expected duration of the Trip (second)",
                        "type":"integer"
                    },
                    "vehicle":{
                        "$ref":"#/definitions/Vehicle_receive"
                    },
                    "tripContext":{
                        "description":"List of Trip Context for the trip",
                        "type":"array",
                        "items":{
                            "$ref":"#/definitions/TripContext_receive"
                        }
                    },
                    "tripTemplateId":{
                        "description":"ID of the tripTemplate associated with the trip",
                        "type":"string"
                    },
                    "driverId":{
                        "description":"ID of the driver associated with the trip",
                        "type":"string"
                    },
                    "name":{
                        "description":"Trip name",
                        "type":"string"
                    },
                    "tripLengthClassification":{
                        "description":"One of [SHORT, MEDIUM, LONG].",
                        "type":"string"
                    },
                    "startTime":{
                        "description":"Trip start time (millisecond) ",
                        "type":"integer"
                    },
                    "id":{
                        "description":"Trip ID",
                        "type":"string"
                    },
                    "vehicleId":{
                        "description":"ID of the vehicle associated with this trip",
                        "type":"string"
                    },
                    "stops":{
                        "description":"List of stops for the trip",
                        "type":"array",
                        "items":{
                            "$ref":"#/definitions/TripStops_receive"
                        }
                    },
                    "endTime":{
                        "description":"Trip end time (millisecond) ",
                        "type":"integer"
                    },
                    "tripStatus":{
                        "description":"One of [IN_PROGRESS, COMPLETED, CANCELLED].",
                        "type":"string"
                    }
                }
            }
        }
    }
}

Nested Schema : items

Type: array

Show Source

• [0]: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "required":[
            "id",
            "name",
            "tripTemplateId",
            "driverId",
            "vehicleId",
            "vehicle",
            "source",
            "destination",
            "stops",
            "tripStatus",
            "expectedDuration",
            "startTime",
            "endTime",
            "tripLength",
            "lastModifiedTime",
            "totalStops",
            "stopsClassification",
            "tripLengthClassification",
            "tripContext"
        ],
        "properties":{
            "tripLength":{
                "description":"Total length of the Trip",
                "type":"number"
            },
            "lastModifiedTime":{
                "description":"Last modified time (millisecond) ",
                "type":"integer"
            },
            "totalStops":{
                "description":"Total stops for the trip",
                "type":"integer"
            },
            "destination":{
                "$ref":"#/definitions/TripStops_receive"
            },
            "stopsClassification":{
                "description":"One of [SINGLE_STOP, DUAL_STOP, TRIPLE_STOP, MULTI_STOP, NON_STOP].",
                "type":"string"
            },
            "source":{
                "$ref":"#/definitions/TripStops_receive"
            },
            "expectedDuration":{
                "description":"Expected duration of the Trip (second)",
                "type":"integer"
            },
            "vehicle":{
                "$ref":"#/definitions/Vehicle_receive"
            },
            "tripContext":{
                "description":"List of Trip Context for the trip",
                "type":"array",
                "items":{
                    "$ref":"#/definitions/TripContext_receive"
                }
            },
            "tripTemplateId":{
                "description":"ID of the tripTemplate associated with the trip",
                "type":"string"
            },
            "driverId":{
                "description":"ID of the driver associated with the trip",
                "type":"string"
            },
            "name":{
                "description":"Trip name",
                "type":"string"
            },
            "tripLengthClassification":{
                "description":"One of [SHORT, MEDIUM, LONG].",
                "type":"string"
            },
            "startTime":{
                "description":"Trip start time (millisecond) ",
                "type":"integer"
            },
            "id":{
                "description":"Trip ID",
                "type":"string"
            },
            "vehicleId":{
                "description":"ID of the vehicle associated with this trip",
                "type":"string"
            },
            "stops":{
                "description":"List of stops for the trip",
                "type":"array",
                "items":{
                    "$ref":"#/definitions/TripStops_receive"
                }
            },
            "endTime":{
                "description":"Trip end time (millisecond) ",
                "type":"integer"
            },
            "tripStatus":{
                "description":"One of [IN_PROGRESS, COMPLETED, CANCELLED].",
                "type":"string"
            }
        }
    }
}

Nested Schema : links

Type: array

The set of API navigation links.

Show Source

• [0]: object items

{
    "description":"The set of API navigation links.",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "rel":{
                "description":"Relation type",
                "type":"string",
                "example":"canonical"
            },
            "href":{
                "description":"The target resource URI",
                "type":"string",
                "example":"https://iotserver/iot/api/vX/some/API/path"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• destination: object TripStops_receive
• driverId: string
  ID of the driver associated with the trip
• endTime: integer
  Trip end time (millisecond)
• expectedDuration: integer
  Expected duration of the Trip (second)
• id: string
  Trip ID
• lastModifiedTime: integer
  Last modified time (millisecond)
• name: string
  Trip name
• source: object TripStops_receive
• startTime: integer
  Trip start time (millisecond)
• stops: array stops
  List of stops for the trip
• stopsClassification: string
  One of [SINGLE_STOP, DUAL_STOP, TRIPLE_STOP, MULTI_STOP, NON_STOP].
• totalStops: integer
  Total stops for the trip
• tripContext: array tripContext
  List of Trip Context for the trip
• tripLength: number
  Total length of the Trip
• tripLengthClassification: string
  One of [SHORT, MEDIUM, LONG].
• tripStatus: string
  One of [IN_PROGRESS, COMPLETED, CANCELLED].
• tripTemplateId: string
  ID of the tripTemplate associated with the trip
• vehicle: object Vehicle_receive
• vehicleId: string
  ID of the vehicle associated with this trip

{
    "type":"object",
    "required":[
        "id",
        "name",
        "tripTemplateId",
        "driverId",
        "vehicleId",
        "vehicle",
        "source",
        "destination",
        "stops",
        "tripStatus",
        "expectedDuration",
        "startTime",
        "endTime",
        "tripLength",
        "lastModifiedTime",
        "totalStops",
        "stopsClassification",
        "tripLengthClassification",
        "tripContext"
    ],
    "properties":{
        "tripLength":{
            "description":"Total length of the Trip",
            "type":"number"
        },
        "lastModifiedTime":{
            "description":"Last modified time (millisecond) ",
            "type":"integer"
        },
        "totalStops":{
            "description":"Total stops for the trip",
            "type":"integer"
        },
        "destination":{
            "$ref":"#/definitions/TripStops_receive"
        },
        "stopsClassification":{
            "description":"One of [SINGLE_STOP, DUAL_STOP, TRIPLE_STOP, MULTI_STOP, NON_STOP].",
            "type":"string"
        },
        "source":{
            "$ref":"#/definitions/TripStops_receive"
        },
        "expectedDuration":{
            "description":"Expected duration of the Trip (second)",
            "type":"integer"
        },
        "vehicle":{
            "$ref":"#/definitions/Vehicle_receive"
        },
        "tripContext":{
            "description":"List of Trip Context for the trip",
            "type":"array",
            "items":{
                "$ref":"#/definitions/TripContext_receive"
            }
        },
        "tripTemplateId":{
            "description":"ID of the tripTemplate associated with the trip",
            "type":"string"
        },
        "driverId":{
            "description":"ID of the driver associated with the trip",
            "type":"string"
        },
        "name":{
            "description":"Trip name",
            "type":"string"
        },
        "tripLengthClassification":{
            "description":"One of [SHORT, MEDIUM, LONG].",
            "type":"string"
        },
        "startTime":{
            "description":"Trip start time (millisecond) ",
            "type":"integer"
        },
        "id":{
            "description":"Trip ID",
            "type":"string"
        },
        "vehicleId":{
            "description":"ID of the vehicle associated with this trip",
            "type":"string"
        },
        "stops":{
            "description":"List of stops for the trip",
            "type":"array",
            "items":{
                "$ref":"#/definitions/TripStops_receive"
            }
        },
        "endTime":{
            "description":"Trip end time (millisecond) ",
            "type":"integer"
        },
        "tripStatus":{
            "description":"One of [IN_PROGRESS, COMPLETED, CANCELLED].",
            "type":"string"
        }
    }
}

Nested Schema : TripStops_receive

Type: object

Show Source

• address: string
  Unified full address, e.g. 500 Oracle Parkway::Redwood City::CA::US::94065 . Must be provided if geoLocation is not specified.
• arrivalTime: integer
  Trip arrival time (millisecond)
• city: string
  Name of City
• country: string
  Name of country
• departureTime: integer
  Trip departure time (millisecond)
• distanceToNextStop: number
  Estimated distance to next stop
• estimatedArrivalTime: integer
  Estimated arrival time (millisecond)
• estimatedDepartureTime: integer
  Estimated departure time (millisecond)
• estimatedTimeToNextStop: integer
  Estimated time it will take to reach next stop (second)
• expectedDurationFromStart: integer
  Expected duration to reach from Start to this Stop (second)
• geoLocation: object GeoPosition_receive
• plannedArrivalTime: integer
  Planned Trip arrival time (in millisecond)
• plannedDepartureTime: integer
  Planned Trip departure time (in millisecond)
• postalCode: string
  Postal/Zip code
• state: string
  Name of State
• stopDurationInSeconds: integer
  Stop duration in seconds
• stopSequence: integer
  Property description was not set
• stopType: string
  The reason for stopping
• street: string
  Name of Street
• timeZone: string
  Time zone of the time fields

{
    "type":"object",
    "required":[
        "timeZone",
        "stopType",
        "stopDurationInSeconds",
        "arrivalTime",
        "estimatedArrivalTime",
        "estimatedDepartureTime",
        "departureTime",
        "plannedArrivalTime",
        "plannedDepartureTime",
        "city",
        "postalCode",
        "geoLocation",
        "stopSequence",
        "street",
        "expectedDurationFromStart",
        "estimatedTimeToNextStop",
        "distanceToNextStop",
        "address",
        "state",
        "country"
    ],
    "properties":{
        "departureTime":{
            "description":"Trip departure time (millisecond)",
            "type":"integer"
        },
        "stopDurationInSeconds":{
            "description":"Stop duration in seconds",
            "type":"integer"
        },
        "distanceToNextStop":{
            "description":"Estimated distance to next stop",
            "type":"number"
        },
        "country":{
            "description":"Name of country",
            "type":"string"
        },
        "stopSequence":{
            "description":"Property description was not set",
            "type":"integer"
        },
        "address":{
            "description":"Unified full address, e.g. 500 Oracle Parkway::Redwood City::CA::US::94065 . Must be provided if geoLocation is not specified.",
            "type":"string"
        },
        "city":{
            "description":"Name of City",
            "type":"string"
        },
        "plannedArrivalTime":{
            "description":"Planned Trip arrival time (in millisecond)",
            "type":"integer"
        },
        "postalCode":{
            "description":"Postal/Zip code",
            "type":"string"
        },
        "expectedDurationFromStart":{
            "description":"Expected duration to reach from Start to this Stop (second)",
            "type":"integer"
        },
        "timeZone":{
            "description":"Time zone of the time fields",
            "type":"string"
        },
        "plannedDepartureTime":{
            "description":"Planned Trip departure time (in millisecond)",
            "type":"integer"
        },
        "stopType":{
            "description":"The reason for stopping",
            "type":"string"
        },
        "estimatedTimeToNextStop":{
            "description":"Estimated time it will take to reach next stop (second)",
            "type":"integer"
        },
        "estimatedDepartureTime":{
            "description":"Estimated departure time (millisecond)",
            "type":"integer"
        },
        "geoLocation":{
            "$ref":"#/definitions/GeoPosition_receive"
        },
        "arrivalTime":{
            "description":"Trip arrival time (millisecond)",
            "type":"integer"
        },
        "street":{
            "description":"Name of Street",
            "type":"string"
        },
        "state":{
            "description":"Name of State",
            "type":"string"
        },
        "estimatedArrivalTime":{
            "description":"Estimated arrival time (millisecond)",
            "type":"integer"
        }
    }
}

Nested Schema : stops

Type: array

List of stops for the trip

Show Source

• [0]: object TripStops_receive

{
    "description":"List of stops for the trip",
    "type":"array",
    "items":{
        "$ref":"#/definitions/TripStops_receive"
    }
}

Nested Schema : tripContext

Type: array

List of Trip Context for the trip

Show Source

• [0]: object TripContext_receive

{
    "description":"List of Trip Context for the trip",
    "type":"array",
    "items":{
        "$ref":"#/definitions/TripContext_receive"
    }
}

Nested Schema : Vehicle_receive

Type: object

Show Source

• id: string
  vehicle ID
• name: string
  vehicle name
• registrationNumber: string
  vehicle registration number

{
    "type":"object",
    "required":[
        "registrationNumber",
        "name",
        "id"
    ],
    "properties":{
        "registrationNumber":{
            "description":"vehicle registration number",
            "type":"string"
        },
        "name":{
            "description":"vehicle name",
            "type":"string"
        },
        "id":{
            "description":"vehicle ID",
            "type":"string"
        }
    }
}

Nested Schema : GeoPosition_receive

Type: object

Show Source

• additionalElements: array additionalElements
  Property description was not set
• altitude: number
  Property description was not set
• latitude: number
  Property description was not set
• longitude: number
  Property description was not set
• valid: boolean
  Property description was not set

{
    "type":"object",
    "required":[
        "valid",
        "longitude",
        "latitude",
        "altitude",
        "additionalElements"
    ],
    "properties":{
        "valid":{
            "description":"Property description was not set",
            "type":"boolean"
        },
        "altitude":{
            "description":"Property description was not set",
            "type":"number"
        },
        "latitude":{
            "description":"Property description was not set",
            "type":"number"
        },
        "longitude":{
            "description":"Property description was not set",
            "type":"number"
        },
        "additionalElements":{
            "description":"Property description was not set",
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    }
}

Nested Schema : additionalElements

Type: array

Property description was not set

Show Source

• [0]: string

{
    "description":"Property description was not set",
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : TripContext_receive

Type: object

Show Source

• externalId: string
  The ID of the shipment in the external system, in case of connected systems
• name: string
  Trip Context name
• type: string
  Trip Context type either Shipment or default trip
• value: string
  Trip Context Id, either Trip or Shipment Id

{
    "type":"object",
    "required":[
        "value",
        "name",
        "type",
        "externalId"
    ],
    "properties":{
        "name":{
            "description":"Trip Context name",
            "type":"string"
        },
        "externalId":{
            "description":"The ID of the shipment in the external system, in case of connected systems",
            "type":"string"
        },
        "type":{
            "description":"Trip Context type either Shipment or default trip",
            "type":"string"
        },
        "value":{
            "description":"Trip Context Id, either Trip or Shipment Id",
            "type":"string"
        }
    }
}

Nested Schema : items

Type: object

Show Source

• href: string
  The target resource URI

  Example: https://iotserver/iot/api/vX/some/API/path
• rel: string
  Relation type

  Example: canonical

{
    "type":"object",
    "properties":{
        "rel":{
            "description":"Relation type",
            "type":"string",
            "example":"canonical"
        },
        "href":{
            "description":"The target resource URI",
            "type":"string",
            "example":"https://iotserver/iot/api/vX/some/API/path"
        }
    }
}

401 Response

Unauthorized. The request requires user authentication.

406 Response

Not Acceptable. The resource identified by the request is only capable of generating response entities which have content characteristics not acceptable according to the accept headers sent in the request.

Examples

curl -X GET 
   -u <username>:<password> 
   -H 'Accept: application/json' 
   https://iotserver/fleetMonitoring/clientapi/v2/trips 

Example of Response Body

The following example shows the content of the response body in JSON format:

{
    "items": [
        {
            "id": "D9B17614-5112-41B4-AA02-981C8F6C49F8",
            "name": "HQ-SFO-SCA-Vehicle_Name",
            "driverId": "7BE01256-8567-44BF-8DA3-8AEE26F33F35",
            "vehicleId": "09DE39F0-A091-46B7-B0E9-3C21CC56EFE5",
            "source": {
                "address": "500 Oracle Parkway::Redwood City::CA::US::94065",
                "geoLocation": [
                    -122.26223,
                    37.53084
                ],
                "estimatedTimeToNextStop": 1945,
                "distanceToNextStop": 23.997354694103965,
                "expectedDurationFromStart": 0,
                "city": "Redwood City",
                "country": "US",
                "plannedArrivalTime": 1519810576752,
                "plannedDepartureTime": 1519810576752,
                "postalCode": "94065",
                "state": "CA",
                "stopDurationInSeconds": 0,
                "street": "500 Oracle Parkway",
                "stopSequence": 0
            },
            "destination": {
                "address": "4210 Network Circle::Santa Clara::CA::US::95054",
                "geoLocation": [
                    -121.95267,
                    37.39124
                ],
                "estimatedTimeToNextStop": 0,
                "distanceToNextStop": 0,
                "expectedDurationFromStart": 172800,
                "city": "Santa Clara",
                "country": "US",
                "plannedArrivalTime": 1519983376752,
                "plannedDepartureTime": 1519983376752,
                "postalCode": "95054",
                "state": "CA",
                "stopDurationInSeconds": 0,
                "street": "4210 Network Circle",
                "stopSequence": 1
            },
            "stops": [
                {
                    "address": "475 Sansome Street::San Francisco::CA::US::94111",
                    "geoLocation": [
                        -122.40143,
                        37.79461
                    ],
                    "estimatedTimeToNextStop": 3100,
                    "distanceToNextStop": 44.78222147367256,
                    "expectedDurationFromStart": 43200,
                    "city": "San Francisco",
                    "country": "US",
                    "plannedArrivalTime": 1519853776752,
                    "plannedDepartureTime": 1519853776752,
                    "postalCode": "94111",
                    "state": "CA",
                    "stopDurationInSeconds": 0,
                    "street": "475 Sansome Street",
                    "stopSequence": 2
                }
            ],
            "tripStatus": "IN_PROGRESS",
            "expectedDuration": 5046,
            "startTime": 1519810577014,
            "endTime": -1,
            "tripLength": 68.35083089999999,
            "lastModifiedTime": 1519810577304,
            "stopsCompleted": 0,
            "totalStops": 1,
            "stopsClassification": "SINGLE_STOP",
            "tripLengthClassification": "SHORT",
            "tripContext": [
                {
                    "value": "D9B17614-5112-41B4-AA02-981C8F6C49F8",
                    "name": "HQ-SFO-SCA-Vehicle_Name",
                    "type": "TRIP"
                }
            ],
            "links": [
                {
                    "href": "https://iotserver/fleetMonitoring/clientapi/v2/vehicles/09DE39F0-A091-46B7-B0E9-3C21CC56EFE5",
                    "rel": "vehicle"
                },
                {
                    "href": "https://iotserver/fleetMonitoring/clientapi/v2/drivers/7BE01256-8567-44BF-8DA3-8AEE26F33F35",
                    "rel": "driver"
                }
            ]
        },
        {
            "id": "DA50A721-5F06-4D3D-ACDB-BE85F10BB696",
            "name": "HQ-SFO-SCA-Vehicle_Name",
            "driverId": "E8E8B1E4-0D8A-4ECB-95CA-A555510D3D49",
            "vehicleId": "9E921611-F05A-4356-BE40-107E63CA480F",
            "source": {
                "address": "500 Oracle Parkway::Redwood City::CA::US::94065",
                "geoLocation": [
                    -122.26223,
                    37.53084
                ],
                "estimatedTimeToNextStop": 1945,
                "distanceToNextStop": 23.997354694103965,
                "expectedDurationFromStart": 0,
                "city": "Redwood City",
                "country": "US",
                "plannedArrivalTime": 1519811366198,
                "plannedDepartureTime": 1519811366198,
                "postalCode": "94065",
                "state": "CA",
                "stopDurationInSeconds": 0,
                "street": "500 Oracle Parkway",
                "stopSequence": 0
            },
            "destination": {
                "address": "4210 Network Circle::Santa Clara::CA::US::95054",
                "geoLocation": [
                    -121.95267,
                    37.39124
                ],
                "estimatedTimeToNextStop": 0,
                "distanceToNextStop": 0,
                "expectedDurationFromStart": 172800,
                "city": "Santa Clara",
                "country": "US",
                "plannedArrivalTime": 1519984166198,
                "plannedDepartureTime": 1519984166198,
                "postalCode": "95054",
                "state": "CA",
                "stopDurationInSeconds": 0,
                "street": "4210 Network Circle",
                "stopSequence": 1
            },
            "stops": [
                {
                    "address": "475 Sansome Street::San Francisco::CA::US::94111",
                    "geoLocation": [
                        -122.40143,
                        37.79461
                    ],
                    "estimatedTimeToNextStop": 3100,
                    "distanceToNextStop": 44.78222147367256,
                    "expectedDurationFromStart": 43200,
                    "city": "San Francisco",
                    "country": "US",
                    "plannedArrivalTime": 1519854566198,
                    "plannedDepartureTime": 1519854566198,
                    "postalCode": "94111",
                    "state": "CA",
                    "stopDurationInSeconds": 0,
                    "street": "475 Sansome Street",
                    "stopSequence": 2
                }
            ],
            "tripStatus": "IN_PROGRESS",
            "expectedDuration": 5046,
            "startTime": 1519811366319,
            "endTime": -1,
            "tripLength": 68.35083089999999,
            "lastModifiedTime": 1519811366415,
            "stopsCompleted": 0,
            "totalStops": 1,
            "stopsClassification": "SINGLE_STOP",
            "tripLengthClassification": "SHORT",
            "tripContext": [
                {
                    "value": "DA50A721-5F06-4D3D-ACDB-BE85F10BB696",
                    "name": "HQ-SFO-SCA-Vehicle_Name",
                    "type": "TRIP"
                }
            ],
            "links": [
                {
                    "href": "https://iotserver/fleetMonitoring/clientapi/v2/vehicles/9E921611-F05A-4356-BE40-107E63CA480F",
                    "rel": "vehicle"
                },
                {
                    "href": "https://iotserver/fleetMonitoring/clientapi/v2/drivers/E8E8B1E4-0D8A-4ECB-95CA-A555510D3D49",
                    "rel": "driver"
                }
            ]
        }
    ],
    "links": [
        {
            "href": "https://iotserver/fleetMonitoring/clientapi/v2/trips?offset=0&limit=10",
            "rel": "self"
        },
        {
            "href": "https://iotserver/fleetMonitoring/clientapi/v2/trips",
            "rel": "canonical"
        },
        {
            "href": "https://iotserver/fleetMonitoring/clientapi/v2/trips?offset=0&limit=10",
            "rel": "first"
        },
        {
            "href": "https://iotserver/fleetMonitoring/clientapi/v2/trips?offset=0&limit=10",
            "rel": "last"
        }
    ],
    "offset": 0,
    "limit": 10,
    "count": 2,
    "hasMore": false
} 

Complete cURL Example

The following example shows a complete cURL command that you can use to perform the described operation:

curl -X GET 
   -u <username>:<password> 
   -H 'Accept: application/json' 
   https://iotserver/fleetMonitoring/clientapi/v2/trips 

Note that in the request, https://iotserver will be replaced by the name and port of your assigned IoT Cloud Service instance. The format of the Cloud Service instance is https://myinstance-myidentitydomain.iot.us.oraclecloud.com and the default port is 443.