# Get Vehicle Trips

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /openapi/trips/:
    get:
      summary: Get Vehicle Trips
      deprecated: false
      description: >-
        Get historical trips data for filtered vehicles. This method returns a
        set of historical trips data for vehicles in the specified time range.
      operationId: trips_list
      tags:
        - Trips
        - Trips
      parameters:
        - name: page
          in: query
          description: A page number within the paginated result set.
          required: false
          schema:
            type: integer
        - name: page_size
          in: query
          description: Number of results to return per page.
          required: false
          schema:
            type: integer
        - name: vehicleIds
          in: query
          description: ''
          required: false
          schema:
            type: array
            items:
              type: string
              format: uuid
        - name: startedAfter
          in: query
          description: '2024-05-22T01:40:16.274753Z'
          required: false
          schema:
            type: string
            format: date-time
        - name: startedBefore
          in: query
          description: '2024-05-22T01:40:16.274753Z'
          required: false
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTripResponseList'
          headers: {}
          x-apidog-name: OK
      security: []
      x-apidog-folder: Trips
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/586350/apis/api-8318759-run
components:
  schemas:
    PaginatedTripResponseList:
      type: object
      properties:
        count:
          type: integer
          examples:
            - 10
        page_size:
          type: integer
          examples:
            - 123
        previous:
          type: integer
          examples:
            - null
          nullable: true
        current:
          type: integer
          examples:
            - 1
        next:
          type: integer
          examples:
            - 2
          nullable: true
        results:
          type: array
          items:
            $ref: '#/components/schemas/TripResponse'
      x-apidog-orders:
        - count
        - page_size
        - previous
        - current
        - next
        - results
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    TripResponse:
      type: object
      properties:
        vehicle_id:
          type: string
          format: uuid
          description: Vehicle ID
        items:
          type: array
          items:
            $ref: '#/components/schemas/VehicleRoute'
      required:
        - vehicle_id
        - items
      x-apidog-orders:
        - vehicle_id
        - items
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    VehicleRoute:
      type: object
      properties:
        id:
          type: string
          default: ''
        driver_id:
          type: string
          default: ''
        driver_first_name:
          type: string
          default: ''
        driver_last_name:
          type: string
          default: ''
        start_event_datetime:
          type: string
          format: date-time
          nullable: true
        start_total_odometer:
          type: number
          format: double
          default: 0
          nullable: true
        end_event_datetime:
          type: string
          format: date-time
          nullable: true
        end_total_odometer:
          type: number
          format: double
          default: 0
          nullable: true
        duration:
          type: integer
          default: 0
        distance:
          type: number
          format: double
          default: 0
        snapshot:
          type: string
          format: uri
          nullable: true
        start: &ref_0
          $ref: '#/components/schemas/VehicleRouteStartEnd'
        locations:
          type: array
          items: &ref_1
            $ref: '#/components/schemas/VehicleRouteLocation'
        end: *ref_0
      required:
        - locations
      x-apidog-orders:
        - id
        - driver_id
        - driver_first_name
        - driver_last_name
        - start_event_datetime
        - start_total_odometer
        - end_event_datetime
        - end_total_odometer
        - duration
        - distance
        - snapshot
        - start
        - locations
        - end
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    VehicleRouteLocation:
      type: object
      properties:
        latitude:
          type: number
          format: double
          default: 0
        longitude:
          type: number
          format: double
          default: 0
        address:
          type: string
          default: ''
      x-apidog-orders:
        - latitude
        - longitude
        - address
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    VehicleRouteStartEnd:
      type: object
      properties:
        event_datetime:
          type: string
          format: date-time
          nullable: true
        total_odometer:
          type: number
          format: double
          default: 0
          nullable: true
        location: *ref_1
      x-apidog-orders:
        - event_datetime
        - total_odometer
        - location
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://api.firsteld.com
    description: Prod Env
security: []

```