# Retrieve Trips

Retrieve a list of all the trips in an organization or subset of an organization.

Endpoint: GET /v1/trips
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `deviceIdentifier` (string)
    Filter by device identifier or serial number.
    Example: "5100FFFF-60B6-D7CD-3FA2-22CA712B0000"

  - `vehicleIdentifier` (string)
    Filter by vehicle identifier or VIN.
    Example: "5100DDDD-60B6-D7CD-3FA2-22CA712B0000"

  - `userIdentifier` (string)
    Filter by user identifier.
    Example: "5100CCCC-60B6-D7CD-3FA2-22CA712B0000"

  - `groupIdentifier` (string)
    Filter by group identifier.
    Example: "5100BBBB-60B6-D7CD-3FA2-22CA712B0000"

  - `startDate` (string)
    Filter by start date.
    Example: "2023-09-10"

  - `endDate` (string)
    Filter by end date.
    Example: "2023-09-30"

  - `offset` (integer)
    Record to start with.
    Example: "1"

  - `limit` (integer)
    Number of records to return.
    Example: "100"

  - `order` (string)
    Sort direction.
    Example: "asc"

  - `sort` (string)
    Name of property to sort on.
    Example: "EndDate"

  - `includeSubgroups` (boolean)
    Include subgroups.
    Example: "false"

## Response 200 fields (application/json):

  - `metadata` (object)

  - `metadata.offset` (integer)

  - `metadata.limit` (integer)

  - `metadata.count` (integer)

  - `metadata.startDate` (string)

  - `metadata.endDate` (string)

  - `data` (array,null)

  - `data.tripId` (string)

  - `data.startDate` (string)

  - `data.endDate` (string)

  - `data.creationDateTime` (string)

  - `data.startPosition` (object,null)

  - `data.startPosition.latitude` (number)

  - `data.startPosition.longitude` (number)

  - `data.startPosition.address` (string)

  - `data.startPosition.occurrenceDateTime` (string)

  - `data.startPosition.timezoneOffset` (integer)

  - `data.endPosition` (object,null)

  - `data.endPosition.latitude` (number)

  - `data.endPosition.longitude` (number)

  - `data.endPosition.address` (string)

  - `data.endPosition.occurrenceDateTime` (string)

  - `data.endPosition.timezoneOffset` (integer)

  - `data.maxSpeedKph` (number)

  - `data.distanceKm` (number)

  - `data.driver` (object,null)

  - `data.driver.id` (string)

  - `data.driver.firstName` (string)

  - `data.driver.lastName` (string)

  - `data.driver.employeeNumber` (string)

  - `data.vehicle` (object,null)

  - `data.vehicle.id` (string)

  - `data.vehicle.imei` (string)

  - `data.vehicle.serialNumber` (string)

  - `data.vehicle.vehicleName` (string)

  - `data.vehicle.deviceId` (string)

  - `data.vehicle.licensePlate` (string)

  - `data.vehicle.vin` (string)

  - `data.vehicle.groupId` (string)

  - `data.vehicle.groupAppId` (integer)

  - `data.vehicle.groupName` (string)

  - `data.eventRecorderTimezone` (string)

## Response 400 fields (application/json):

  - `error` (string)

  - `message` (string)