# List all vehicles

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /openapi/vehicles/:
    get:
      summary: List all vehicles
      deprecated: false
      description: Returns a list of all vehicles.
      operationId: vehicles_list
      tags:
        - Vehicles
        - Vehicles
      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: modifiedBefore
          in: query
          description: '2024-05-22T01:40:16.274753Z'
          required: false
          schema:
            type: string
            format: date-time
        - name: modifiedAfter
          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/PaginatedVehicleList'
              examples:
                VehiclesResponse(paginated):
                  summary: Vehicles Response (paginated)
                  value:
                    count: 10
                    page_size: 123
                    previous: null
                    current: 1
                    next: 2
                    results:
                      - count: 10
                        page_size: 50
                        previous: null
                        current: 1
                        next: 2
                        results:
                          - id: 770e8400-e29b-41d4-a716-446655440002
                            status: active
                            vin: 1HGBH41JXMN109186
                            name: Truck-001
                            make: Freightliner
                            model: Cascadia
                            year: '2022'
                            licensePlate:
                              state: TX
                              number: ABC-1234
          headers: {}
          x-apidog-name: OK
      security: []
      x-apidog-folder: Vehicles
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/586350/apis/api-8318760-run
components:
  schemas:
    PaginatedVehicleList:
      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/Vehicle'
      x-apidog-orders:
        - count
        - page_size
        - previous
        - current
        - next
        - results
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Vehicle:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        status:
          type: string
          readOnly: true
          description: Status of the vehicle
        vin:
          type: string
          maxLength: 17
        name:
          type: string
          description: Unit number of the vehicle
        make:
          type: string
          maxLength: 50
          nullable: true
        model:
          type: string
          maxLength: 100
          nullable: true
        year:
          type: string
          description: Year of the vehicle
        licensePlate:
          allOf:
            - $ref: '#/components/schemas/LicensePlate'
          description: License plate of the vehicle
      required:
        - id
        - status
        - vin
        - name
        - year
        - licensePlate
      x-apidog-orders:
        - id
        - status
        - vin
        - name
        - make
        - model
        - year
        - licensePlate
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    LicensePlate:
      type: object
      properties:
        state:
          type: string
          description: State
        number:
          type: string
      required:
        - state
        - number
      x-apidog-orders:
        - state
        - number
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://api.firsteld.com
    description: Prod Env
security: []

```
