> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.datatruck.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Driver List

> Retrieves a paginated list of active drivers, including their truck, trailer, dispatcher, team driver, payment tariff, and emergency contact details.



## OpenAPI

````yaml GET /drivers/list/
openapi: 3.0.1
info:
  title: OpenAPI Datatruck
  description: >-
    To be able to use Datatruck OpenAPI you should create tokens from your
    dashboard. Go to your dashboard and create token with appropriate scopes and
    expiration. Expiration and scopes are optional as well as description for
    your token, but remember name is required.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://{company}.datatruck.io/api/v1/openapi/
security: []
paths:
  /drivers/list/:
    get:
      summary: List Drivers
      description: >-
        Retrieves a paginated list of active drivers, including their truck,
        trailer, dispatcher, team driver, payment tariff, and emergency contact
        details.
      operationId: listDrivers
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            example: 1
          description: Page number for paginated results.
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            example: 10
            maximum: 25
          description: Number of results per page (max 25, default 10).
        - name: ordering
          in: query
          required: false
          schema:
            type: string
            example: account__last_name
          description: ORM field path to order by. Prefix with `-` for descending.
        - name: filter
          in: query
          required: false
          schema:
            type: string
            example: >-
              [{"column":"driver_type","value":"Owner
              Operator","contains":"is"}]
          description: >-
            JSON-encoded array of filter objects. Each object has `column`,
            `value`, and `contains` (operator). Supported operators: `is`,
            `is_not`, `is_in`, `is_not_in`, `contains`, `before`, `after`,
            `greater_than`, `less_than`, `between`, `between_datetime`,
            `isnull`, `today`, `exclude`, `exclude_in`.
      responses:
        '200':
          description: Successful response with a paginated list of drivers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListDriversResponse'
components:
  schemas:
    ListDriversResponse:
      type: object
      properties:
        count:
          type: integer
          description: Total number of drivers.
        next:
          type: string
          nullable: true
          description: URL to the next page of results.
        previous:
          type: string
          nullable: true
          description: URL to the previous page of results.
        results:
          type: array
          items:
            $ref: '#/components/schemas/ListDriversResponseItem'
          description: List of driver entries.
      required:
        - count
        - next
        - previous
        - results
    ListDriversResponseItem:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the driver.
        account:
          type: object
          properties:
            first_name:
              type: string
              nullable: true
              description: First name of the driver.
            last_name:
              type: string
              nullable: true
              description: Last name of the driver.
            full_name:
              type: string
              nullable: true
              description: Full name of the driver.
            username:
              type: string
              nullable: true
              description: Username of the driver.
            email:
              type: string
              nullable: true
              description: Email address of the driver.
        gender:
          type: string
          nullable: true
          description: Gender of the driver.
        contact_number:
          type: string
          description: Contact number of the driver.
        address1:
          type: string
          nullable: true
          description: Primary address of the driver.
        address2:
          type: string
          nullable: true
          description: Secondary address of the driver.
        city:
          type: string
          nullable: true
        state:
          type: string
          nullable: true
        zip_code:
          type: string
          nullable: true
        status:
          type: string
          description: Current status of the driver.
        employee_status:
          type: string
          description: Employment status of the driver.
        driver_type:
          type: string
          description: Type of driver.
        payment_tariff:
          type: object
          nullable: true
          properties:
            id:
              type: integer
            tariff:
              type: string
            name:
              type: string
        hire_date:
          type: string
          format: date
          nullable: true
        rehire_date:
          type: string
          format: date
          nullable: true
        termination_note:
          type: string
          nullable: true
        terminate_reason:
          type: string
          nullable: true
        previous_terminate_note:
          type: string
          nullable: true
        assigned_truck:
          type: object
          nullable: true
          properties:
            id:
              type: integer
            unit_number:
              type: string
            plate_number:
              type: string
              nullable: true
        assigned_trailer:
          type: object
          nullable: true
          properties:
            id:
              type: integer
            unit_number:
              type: string
            plate_number:
              type: string
              nullable: true
        team_driver:
          type: object
          nullable: true
          properties:
            id:
              type: integer
            full_name:
              type: string
        assigned_dispatcher:
          type: object
          nullable: true
          properties:
            id:
              type: integer
            full_name:
              type: string
        other_id:
          type: string
          nullable: true
        safety_start_on:
          type: string
          format: date
          nullable: true
        emergency_contact_name:
          type: string
          nullable: true
        emergency_contact_number:
          type: string
          nullable: true
        emergency_relationship:
          type: string
          nullable: true
        emergency_contact_email:
          type: string
          nullable: true
        emergency_contact_address1:
          type: string
          nullable: true
        emergency_contact_address2:
          type: string
          nullable: true
        emergency_contact_state:
          type: string
          nullable: true
        emergency_contact_city:
          type: string
          nullable: true
        emergency_contact_zip_code:
          type: string
          nullable: true
      required:
        - id
        - contact_number
        - status
        - employee_status
        - driver_type

````