---
title: "List Equipment"
method: GET
path: "/equipment"
tags: ["Equipment"]
---

# List Equipment

`GET /equipment`

## Request

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

Returns a list of your Equipment. Archived Equipment is not included in
the results.

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `brand` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `name` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `model` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `serial_number` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `labels` IncludeFilter
    - `include` string, required
  - `current_location_entry_id` EqFilter
    - `eq` string, required
  - `group_id` EqFilter
    - `eq` string, required
  - `in_service_date` union
    - object
      - `eq` string, required
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `out_of_service_date` union
    - object
      - `eq` string, required
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `purchase_date` union
    - object
      - `eq` string, required
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` 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` object
  - `in_service_date` 'asc' | 'desc'
  - `out_of_service_date` 'asc' | 'desc'
  - `purchase_date` '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.
    - union
      - object
        - `brand` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `name` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `model` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `serial_number` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `labels` IncludeFilter
          - `include` string, required
      - object
        - `current_location_entry_id` EqFilter
          - `eq` string, required
      - object
        - `group_id` EqFilter
          - `eq` string, required
      - object
        - `in_service_date` union
          - object
            - `eq` string, required
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `out_of_service_date` union
          - object
            - `eq` string, required
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `purchase_date` union
          - object
            - `eq` string, required
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` 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
        - `in_service_date` 'asc' | 'desc'
      - object
        - `out_of_service_date` 'asc' | 'desc'
      - object
        - `purchase_date` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `updated_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
  - `records` EquipmentSummary[]
    - `created_at` string, date-time, required: The date and time at which this record was created.
    - `updated_at` string, date-time, required: The date and time at which this record was most recently updated.
    - `id` integer, required
    - `name` string, required: The name for this Equipment.
    - `brand` string, nullable, required: The name of the brand which makes this Equipment.
    - `model` string, nullable, required: The model name of this Equipment.
    - `serial_number` string, nullable, required: The serial number of this Equipment.
    - `equipment_type_id` integer, required
    - `type_name` string, required: The name of the associated `Equipment Type`.
    - `equipment_status_id` integer, required
    - `status_name` string, required: The name of the associated `Equipment Status`.
    - `group_id` integer, nullable, required
    - `purchase_vendor_id` integer, nullable, required
    - `purchase_price_cents` integer, nullable, required: The purchase price in cents.
    - `purchase_date` string, date, nullable, required: The date on which the Equipment was purchased.
    - `estimated_resale_price_cents` integer, nullable, required: The estimated resale price in cents of this Equipment.
    - `warranty_expiration_date` string, date, nullable, required: The date on which the Equipment warranty expires.
    - `purchase_comments` string, nullable, required: Any comments about the purchase of this Equipment.
    - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields).
    - `in_service_date` string, date, nullable, required: The date on which the Equipment was put into service.
    - `estimated_service_life` integer, nullable, required: The estimated duration in months of the service life for this Equipment.
    - `out_of_service_date` string, date, nullable, required: The estimated date on which the Equipment will be retired from service.
    - `archived_at` string, date-time, nullable, required: The date and time at which the Equipment was archived.
    - `status_color` string, nullable, required: The color of the associated `Equipment Status`.
    - `purchase_vendor` VendorMini, nullable: A Vendor
      - `name` string, required: The name of the Vendor.
      - `phone` string, nullable, required: The phone number of the Vendor.
      - `city` string, nullable, required: The city of the Vendor.
      - `region` string, nullable, required: The region, state, province, or territory of the Vendor.
      - `postal_code` string, nullable, required: The postal code or ZIP code of the Vendor.
      - `country` string, nullable, required: The country of the Vendor.
      - `external_id` string, nullable, required: The external identifier of the Vendor.
    - `linked_vehicle` VehicleMini: A Vehicle
      - `id` integer, required
      - `name` string, required: This vehicle's name.
      - `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` string, 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.
    - `assigned_contact` 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.
    - `attachment_permissions` AttachmentPermissions, nullable, required
      - `read_photos` boolean: Indicates whether the user has read permission for photos.
      - `manage_photos` boolean: Indicates whether the user has permission to manage (eg. upload, delete) photos.
      - `read_documents` boolean: Indicates whether the user has read permission for documents.
      - `manage_documents` boolean: Indicates whether the user has permission to manage (eg. upload, delete) documents.
    - `default_image_url` string, nullable, required: The URL of the Equipment's default image/profile photo, if any.
    - `assetable_type` string, nullable, required: The type of assetable object.
    - `comments_count` integer, required: The number of `Comments` associated with this Equipment.
    - `documents_count` integer, required: The number of documents associated with this Equipment.
    - `images_count` integer, required: The number of images associated with this Equipment.
    - `is_watched` boolean, required: Indicates whether this Equipment is being watched.
    - `watchers_count` integer, required: The number of users watching this Equipment.

## 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`: 3 info
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`
  - added the required property `records/items/created_at` to the response with the `200` status
  - added the required property `records/items/updated_at` to the response with the `200` status
- **2025-09-06** `6daa53a03224`: 3 breaking, 2 info
  - the response property `records/items/assigned_contact/default_image_url` became optional for the status `200`
  - the response property `records/items/assigned_contact/id` became optional for the status `200`
  - the response property `records/items/assigned_contact/name` became optional for the status `200`
  - added the optional property `records/items/assigned_contact/employee` to the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/equipment/get.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)