---
title: "Search Vehicles"
method: POST
path: "/vehicles/search"
tags: ["Vehicles"]
---

# Search Vehicles

`POST /vehicles/search`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/vehicles/search`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/vehicles/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of vehicles excluding archived.  Matches
behavior of `List` action, but accepts parameters including 
filters in request body.

## Request body

- object
  - `start_cursor` string
  - `per_page` integer
  - `filter` VehicleFilters
    - `name` union
      - object
        - `like` string, required
      - object
        - `eq` string, required
    - `vin` union
      - object
        - `like` string, required
      - object
        - `eq` string, required
    - `license_plate` union
      - object
        - `like` string, required
      - object
        - `eq` string, required
    - `external_id` LikeFilter
      - `like` string, required
    - `labels` IncludeFilter
      - `include` string, required
    - `group_id` EqFilter
      - `eq` string, required
    - `vehicle_status_id` EqFilter
      - `eq` string, required
    - `vehicle_type_id` EqFilter
      - `eq` string, required
    - `created_at` union
      - object
        - `lt` string, required
      - object
        - `lte` string, required
      - object
        - `gt` string, required
      - object
        - `gte` string, required
    - `updated_at` union
      - object
        - `lt` string, required
      - object
        - `lte` string, required
      - object
        - `gt` string, required
      - object
        - `gte` string, required
  - `sort` VehicleSorts
    - `name` 'asc' | 'desc'
    - `created_at` 'asc' | 'desc'
    - `updated_at` 'asc' | 'desc'
    - `id` 'asc' | 'desc'

## Response `200`

OK

- object
  - `start_cursor` string, nullable: The current start cursor of the records returned.
  - `next_cursor` string, nullable: The next cursor to retrieve the next page of records.
  - `per_page` integer: The maximum number of records returned.
  - `estimated_remaining_count` integer: The number of remaining records including the returned records, up to a maximum of 500.
  - `filtered_by` union[]: The filters applied to the returned record set. If you have filtered by custom field filters, these will be returned with the respective `like` or `eq` filter value.
    - union
      - object
        - `name` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `vin` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `license_plate` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `external_id` LikeFilter
          - `like` string, required
      - object
        - `labels` IncludeFilter
          - `include` string, required
      - object
        - `group_id` EqFilter
          - `eq` string, required
      - object
        - `vehicle_status_id` EqFilter
          - `eq` string, required
      - object
        - `vehicle_type_id` EqFilter
          - `eq` string, required
      - object
        - `created_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `updated_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
  - `sorted_by` union[]: The sorts applied to the returned record set.
    - union
      - object
        - `name` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `updated_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
  - `records` VehicleSummary[]
    - `id` integer
    - `account_id` integer
    - `archived_at` string, date-time, nullable: The iso8601 date and time at which the vehicle was archived, for an archived vehicle.
    - `fuel_type_id` integer, nullable
    - `fuel_type_name` string, nullable: The name of the `Fuel Type` associated with this vehicle.
    - `fuel_volume_units` 'us_gallons' | 'uk_gallons' | 'liters'
    - `group_id` integer, nullable
    - `group_name` string, nullable: The name of the `Group` associated with this vehicle, for vehicles associated with a group.
    - `name` string: This vehicle's name.
    - `ownership` 'owned' | 'leased' | 'rented' | 'customer' | 'financed' | 'rent_to_own'
    - `current_location_entry_id` integer, nullable
    - `system_of_measurement` 'imperial' | 'metric'
    - `vehicle_type_id` integer: This vehicles `Vehicle Type` id.
    - `vehicle_type_name` string: The name of the `Vehicle Type` associated with this Vehicle.
    - `is_sample` boolean: Indicates whether this Vehicle record is [Sample Data](https://help.fleetio.com/s/article/Sample-Data).
    - `vehicle_status_id` integer: The id of the `Vehicle Status` of this vehicle.
    - `vehicle_status_name` string: The name of the `Vehicle Status` associated with this Vehicle.
    - `vehicle_status_color` string, nullable: The hex color code of the `Vehicle Status` associated with this Vehicle.
    - `primary_meter_unit` 'km' | 'hr' | 'mi', nullable: The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.
    - `primary_meter_value` string, nullable: The current value of the primary meter for this Vehicle.
    - `primary_meter_date` string, date-time, nullable: The date and time at which the primary meter was last updated.
    - `primary_meter_usage_per_day` string, nullable: The average number of units of the primary meter used per day.
    - `secondary_meter_unit` 'km' | 'hr' | 'mi', nullable: The measurement unit used for the Vehicle's primary, or secondary (if applicable), meter.
    - `secondary_meter_value` string, nullable: The current value of the secondary meter for this Vehicle.
    - `secondary_meter_date` string, date-time, nullable: The date and time at which the secondary meter was last updated.
    - `secondary_meter_usage_per_day` string, nullable: The average number of units of the secondary meter used per day.
    - `in_service_meter_value` string, nullable: The meter value at which this Vehicle was put into service.
    - `in_service_date` string, date-time, nullable: The date on which this Vehicle was put into service.
    - `out_of_service_meter_value` string, nullable: The meter value at which this Vehicle was or will be retired.
    - `out_of_service_date` string, date-time, nullable: The date on which this Vehicle was or will be retired.
    - `estimated_service_months` integer, nullable: The estimated number of months this Vehicle will be in service.
    - `estimated_replacement_mileage` string, nullable: The estimated number of miles before which this Vehicle will be replaced.
    - `estimated_resale_price_cents` integer, nullable: The estimated resale price of this Vehicle in cents.
    - `fuel_entries_count` integer: The number of `Fuel Entries` associated with this Vehicle.
    - `service_entries_count` integer: The number of `Service Entries` associated with this Vehicle.
    - `service_reminders_count` integer: The number of `Service Reminders` associated with this Vehicle.
    - `vehicle_renewal_reminders_count` integer: The number of `Vehicle Renewal Reminders` associated with this Vehicle.
    - `comments_count` integer: The number of `Comments` associated with this Vehicle.
    - `documents_count` integer: The number of documents attached to this Vehicle.
    - `images_count` integer: The number of images attached to this Vehicle.
    - `issues_count` integer: The number of `Issues` this Vehicle is associated with.
    - `work_orders_count` integer: The number of `Work Orders` this Vehicle is associated with.
    - `labels` object[]
      - `id` integer
      - `name` string
    - `group_ancestry` string, nullable: The ancestry of the Group associated with this Vehicle.
    - `color` string, nullable: The color of this Vehicle.
    - `license_plate` string, nullable: The license plate number of this Vehicle.
    - `vin` string, nullable: The Vehicle Identification Number of this Vehicle.
    - `year` number, nullable: This Vehicle's model year.
    - `make` string, nullable: The name of this Vehicle's manufacturer.
    - `model` string, nullable: The name of the model of this Vehicle.
    - `trim` string, nullable: The trim level of this Vehicle.
    - `registration_expiration_month` integer, nullable: The month in which this Vehicle's registration expires.
    - `registration_state` string, nullable: The state, province, or territory in which this Vehicle is registered.
    - `default_image_url_small` string, nullable: The URL of a small-sized version of the default image for this Vehicle.
    - `external_ids` object: Any [External IDs](/docs/guides/vehicles/external-vehicle-ids) associated with this Vehicle.
    - `ai_enabled` boolean: Whether this Vehicle has [Auto Integrate](https://help.fleetio.com/s/article/FAQ-Maintenance-Shop-Integration) enabled for it.
    - `assetable_type` 'Vehicle': Assetable type for Vehicle is always `Vehicle` for vehicles.
    - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields).
    - `axle_config_id` integer, nullable: The id of the `Axle Configuration` of this vehicle.
    - `driver` ContactMini, nullable: A Contact
      - `id` integer
      - `email` string, nullable: The Contact's email address.
      - `name` string, nullable: The Contact's full name.
      - `group_id` integer, nullable: If this Contact belongs to a [Group](/docs/api/groups), this will be the Fleetio ID of that `Group`.
      - `employee` boolean, nullable: Whether or not the Contact is an employee.
      - `employee_number` string, nullable: The employee number of the Contact.
      - `default_image_url` string, nullable: The URL of the Contact's default image/profile photo, if any.
    - `specs` VehicleSpecs
      - `id` integer
      - `vehicle_id` integer: The `Vehicle` ID these specs belong to.
      - `account_id` integer
      - `body_type` string, nullable: The body type of the Vehicle, if available.
      - `body_subtype` string, nullable: The subtype of the Vehicle body, if available.
      - `drive_type` string, nullable: The drive type of the Vehicle, if available.
      - `brake_system` string, nullable: The brake system used in the Vehicle, if available.
      - `msrp_cents` integer, nullable: The Manufacturer's Suggested Retail Price (MSRP) in cents, if available.
      - `fuel_tank_capacity` number, float, nullable: The fuel tank capacity of the Vehicle, if available.
      - `fuel_tank_2_capacity` number, float, nullable: The capacity of a second fuel tank, if available.
      - `front_track_width` number, float, nullable: The front track width of the Vehicle, if available.
      - `ground_clearance` number, float, nullable: The ground clearance of the Vehicle, if available.
      - `height` number, float, nullable: The height of the Vehicle, if available.
      - `length` number, float, nullable: The length of the Vehicle, if available.
      - `rear_track_width` number, float, nullable: The rear track width of the Vehicle, if available.
      - `width` number, float, nullable: The width of the Vehicle, if available.
      - `wheelbase` number, float, nullable: The wheelbase of the Vehicle, if available.
      - `front_tire_psi` string, nullable: The recommended PSI for front tires, if available.
      - `rear_tire_psi` string, nullable: The recommended PSI for rear tires, if available.
      - `base_towing_capacity` number, float, nullable: The base towing capacity of the Vehicle, if available.
      - `curb_weight` number, float, nullable: The curb weight of the Vehicle, if available.
      - `gross_vehicle_weight_rating` number, float, nullable: The Gross Vehicle Weight Rating (GVWR), if available.
      - `bed_length` string, nullable: The length of the Vehicle's bed, if available.
      - `max_payload` number, float, nullable: The maximum payload capacity of the Vehicle, if available.
      - `rear_axle_type` string: The type of rear axle used in the Vehicle.
      - `front_tire_type` string: The type of front tires used in the Vehicle.
      - `front_wheel_diameter` string: The diameter of the front wheels.
      - `rear_tire_type` string: The type of rear tires used in the Vehicle.
      - `rear_wheel_diameter` string: The diameter of the rear wheels.
      - `epa_city` number, float, nullable: The EPA city fuel economy rating, if available.
      - `epa_highway` number, float, nullable: The EPA highway fuel economy rating, if available.
      - `epa_combined` number, float, nullable: The combined EPA fuel economy rating, if available.
      - `engine_description` string: Description of the Vehicle's engine.
      - `engine_brand` string: Brand of the Vehicle's engine.
      - `engine_aspiration` string, nullable: Aspiration type of the engine, if available.
      - `engine_block_type` string, nullable: Block type of the engine, if available.
      - `engine_bore` number, float, nullable: Bore size of the engine, if available.
      - `engine_cam_type` string, nullable: Camshaft type of the engine, if available.
      - `engine_compression` number, float, nullable: Compression ratio of the engine, if available.
      - `engine_cylinders` integer, nullable: Number of engine cylinders, if available.
      - `engine_displacement` number, float, nullable: Engine displacement, if available.
      - `fuel_induction` string, nullable: Fuel induction method, if available.
      - `fuel_quality` string: Fuel quality required for the engine.
      - `max_hp` integer, nullable: Maximum horsepower produced by the engine, if available.
      - `max_torque` integer, nullable: Maximum torque produced by the engine, if available.
      - `oil_capacity` number, float, nullable: Oil capacity of the engine, if available.
      - `redline_rpm` string: Redline RPM of the engine.
      - `engine_stroke` number, float, nullable: Stroke length of the engine, if available.
      - `engine_valves` integer, nullable: Number of engine valves, if available.
      - `transmission_description` string: Description of the Vehicle's transmission.
      - `transmission_brand` string: Brand of the Vehicle's transmission.
      - `transmission_type` string, nullable: Type of transmission, if available.
      - `transmission_gears` integer, nullable: Number of gears in the transmission, if available.
      - `cargo_volume` number, float, nullable: Cargo volume of the Vehicle, if available.
      - `interior_volume` number, float, nullable: Interior volume of the Vehicle, if available.
      - `passenger_volume` string: Passenger volume of the Vehicle.
      - `created_at` string, date-time: The date and time when the specs were created.
      - `updated_at` string, date-time: The date and time when the specs were last updated.
      - `duty_type` string, nullable: Type of duty the Vehicle is designed for, if available.
      - `weight_class` string, nullable: Weight class of the Vehicle, if available.
      - `engine_bore_with_units` string, nullable: Bore size of the engine with units, if available.
      - `wheelbase_with_units` string, nullable: Wheelbase of the Vehicle with units, if available.
      - `msrp` string, nullable: Manufacturer's Suggested Retail Price (MSRP).

## Other responses

- `400`: The format or parameters of the request was invalid
- `401`: Request could not be authenticated
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 1 info
  - the `per_page` request property's min was decreased from `2.00` to `1.00`
- **2026-06-16** `4098a1c81821`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/vehicles/search/post.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)