> ## 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.

# Trailer List

> Retrieves a paginated list of active trailers, including their driver/co-driver operators, trailer type, dispatch status, unit number, VIN, make, model, and year.



## OpenAPI

````yaml GET /trailers/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:
  /trailers/list/:
    get:
      summary: List Trailers
      description: >-
        Retrieves a paginated list of active trailers, including their
        driver/co-driver operators, trailer type, dispatch status, unit number,
        VIN, make, model, and year.
      operationId: listTrailers
      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: search
          in: query
          required: false
          schema:
            type: string
            example: ABC123
          description: >-
            Search term matched against unit_number, plate_number, vin, make,
            and model (case-insensitive).
        - name: status
          in: query
          required: false
          schema:
            type: string
            example: Active
          description: Filter trailers by exact status value.
      responses:
        '200':
          description: Successful response with a paginated list of trailers.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListTrailersResponse'
components:
  schemas:
    ListTrailersResponse:
      type: object
      properties:
        count:
          type: integer
          description: Total number of trailers.
        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/ListTrailersResponseItem'
          description: List of trailer entries.
      required:
        - count
        - next
        - previous
        - results
    ListTrailersResponseItem:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the trailer.
        unit_number:
          type: string
          description: Unit number of the trailer.
        plate_number:
          type: string
          nullable: true
          description: Plate number of the trailer, if available.
        vin:
          type: string
          description: Vehicle Identification Number (VIN) of the trailer.
        make:
          type: string
          description: Manufacturer of the trailer.
        model:
          type: string
          description: Model of the trailer.
        year:
          type: integer
          description: Manufacturing year of the trailer.
        status:
          type: string
          description: Current status of the trailer.
        state:
          type: string
          nullable: true
          description: State where the trailer is registered, if available.
        driver_operator:
          $ref: '#/components/schemas/TrailerDriver'
          nullable: true
          description: Primary driver operator assigned to the trailer, if any.
        co_driver_operator:
          $ref: '#/components/schemas/TrailerDriver'
          nullable: true
          description: Co-driver operator assigned to the trailer, if any.
        type:
          $ref: '#/components/schemas/TrailerType'
          nullable: true
          description: Type of the trailer, if specified.
        dispatch_status:
          $ref: '#/components/schemas/TrailerDispatchStatus'
          nullable: true
          description: Dispatch status of the trailer, if applicable.
      required:
        - id
        - unit_number
        - vin
        - make
        - model
        - year
        - status
    TrailerDriver:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the driver.
        first_name:
          type: string
          description: First name of the driver.
        last_name:
          type: string
          description: Last name of the driver.
      required:
        - id
        - first_name
        - last_name
    TrailerType:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the trailer type.
        name:
          type: string
          description: Name of the trailer type.
      required:
        - id
        - name
    TrailerDispatchStatus:
      type: object
      properties:
        id:
          type: integer
          description: Unique identifier for the dispatch status.
        name:
          type: string
          description: Name of the dispatch status.
        color:
          type: string
          nullable: true
          description: Color associated with the dispatch status, if available.
      required:
        - id
        - name

````