---
title: "List Issues associated with a Vehicle"
method: GET
path: "/vehicles/{id}/issues"
tags: ["Vehicles"]
---

# List Issues associated with a Vehicle

`GET /vehicles/{id}/issues`

## Request

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

Returns a list of Issues associated with a Vehicle.

## Path parameters

- `id` string, required

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `number` EqFilter
    - `eq` string, required
  - `reported_by_id` EqFilter
    - `eq` string, required
  - `assigned_contact_ids` IncludeFilter
    - `include` string, required
  - `labels` IncludeFilter
    - `include` string, required
  - `state` IncludeFilter
    - `include` string, required
  - `due_date` union
    - object
      - `eq` string, required
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `resolved_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `reported_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `closed_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `reopened_at` union
    - 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
  - `due_date` 'asc' | 'desc'
  - `resolved_at` 'asc' | 'desc'
  - `reported_at` 'asc' | 'desc'
  - `updated_at` 'asc' | 'desc'
  - `created_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
        - `reported_by_id` EqFilter
          - `eq` string, required
      - object
        - `labels` IncludeFilter
          - `include` string, required
      - object
        - `state` IncludeFilter
          - `include` string, required
      - object
        - `due_date` union
          - object
            - `eq` string, required
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `resolved_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `reported_at` union
          - 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
      - object
        - `assigned_contact_ids` IncludeFilter
          - `include` string, required
      - object
        - `closed_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `reopened_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
  - `sorted_by` union[]
    - union
      - object
        - `id` 'asc' | 'desc'
      - object
        - `due_date` 'asc' | 'desc'
      - object
        - `updated_at` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `resolved_at` 'asc' | 'desc'
      - object
        - `reported_at` 'asc' | 'desc'
  - `records` VehicleIssueSummary[]
    - `id` integer, required
    - `number` string, required: A unique identifier for the Issue.
    - `state` 'Open' | 'Closed' | 'Resolved', required: The Issue's current state.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `name` string, required: The name of the Issue.
    - `description` string, nullable, required: A longer description of the Issue.
    - `reported_at` string, date-time, nullable, required: The date and time at which the issue was reported.
    - `resolved_at` string, date-time, nullable, required: The date and time at which the issue was resolved.
    - `resolved_by_id` integer, nullable: The id of the `User` who resolved the Issue.
    - `closed_at` string, date-time, nullable: The date and time at which the issue was closed.
    - `closed_by_id` integer, nullable: The id of the `User` who closed the Issue.
    - `reopened_at` string, date-time, nullable: The date and time at which the issue was reopened.
    - `reopened_by_id` integer, nullable: The id of the `User` who reopened the Issue.
    - `resolvable_id` integer, nullable, required: The id of the resolvable_type which can resolve this Issue.
    - `resolvable_type` 'ServiceEntry' | 'WorkOrder', nullable, required: The type of the object which can resolve this Issue.
    - `due_date` string, date, nullable, required: The date on which this Issue should be resolved by. Formatted according to ISO-8601 in `User`'s local time zone.
    - `due_primary_meter_value` string, nullable, required: The primary meter value at which this Issue should be resolved by.
    - `due_secondary_meter_value` number, float, nullable, required: The secondary meter value at which this Issue should be resolved by.
    - `overdue` boolean, required: Indicates whether the Issue is overdue.
    - `asset_type` 'Vehicle' | 'Equipment', required: The type of asset this Issue applies to.
    - `inspection_form_id` integer, nullable, required: The id of the associated `InspectionForm`, if any.
    - `submitted_inspection_form_id` integer, nullable, required: The id of the associated `SubmittedInspectionForm`, if any.
    - `fault_id` integer, nullable, required: The id of the associated `Fault` if any.
    - `external_id` string, nullable, required: The external ID for this Issue.
    - `watchers_count` integer, required: The count of watchers for this Issue.
    - `comments_count` integer, required: The count of comments for this Issue.
    - `documents_count` integer, required: The count of documents for this Issue.
    - `images_count` integer, required: The count of images for this Issue.
    - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields).
    - `reported_by` 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.
    - `fault_rule` FaultRule: A Fault Rule
      - `id` integer
      - `created_at` string, date-time: The date and time at which this record was created.
      - `updated_at` string, date-time: The date and time at which this record was most recently updated.
      - `account_id` integer, required
      - `code` string, required: The diagnostic trouble code.
      - `description` string, nullable, required: A short description about the problem.
      - `priority_handling` 'off' | 'ignore' | 'critical', nullable, required: The priority handling for the alert. This is configurable through the Fleetio dashboard under [Fault Rules](https://help.fleetio.com/s/article/Faults-Overview#add-rules).
      - `name` string, nullable, required: A short name for the alert.
    - `labels` object[]
      - `id` integer
      - `name` string
    - `inspection_items` InspectionItem[]
      - `id` integer: The ID of the Inspection Item.
      - `inspection_form_version_id` integer: The ID of the Inspection Form version to which this item belongs.
      - `account_id` integer: The Fleetio Account ID associated with this Inspection Item.
      - `type` 'InspectionDateItem' | 'InspectionDatetimeItem' | 'InspectionDropdownItem' | 'InspectionFreeTextItem' | 'InspectionMeterEntryItem' | 'InspectionNumericItem' | 'InspectionPassFailItem' | 'InspectionPhotoItem' | 'InspectionSectionItem' | 'InspectionSignatureItem' | 'InspectionSingleCheckboxItem': The type or category of the Inspection Item.
      - `label` string: The label or name of the Inspection Item.
      - `short_description` string, nullable: A brief description of the Inspection Item.
      - `instructions` string, nullable: Instructions or guidance for completing the Inspection Item.
      - `required` boolean: Indicates whether this Inspection Item is required to be completed.
      - `position` integer: The position or order of the Inspection Item within the form.
      - `require_remark_for_fail` boolean: Indicates whether a remark is required for a "Fail" result.
      - `pass_label` string, nullable: The label for a "Pass" result.
      - `fail_label` string, nullable: The label for a "Fail" result.
      - `reuse_pass_fail_label` boolean: Indicates whether to reuse pass/fail labels for this item.
      - `require_secondary_meter_if_one_exists` boolean: Indicates whether a Secondary Meter Entry is required, if a secondary meter is in use.
      - `created_at` string, date-time: The date and time when the Inspection Item was created.
      - `updated_at` string, date-time: The date and time when the Inspection Item was last updated.
      - `version_key` string, nullable: The version key associated with the Inspection Item.
      - `na_label` string, nullable: The label for "Not Applicable" option.
      - `enable_na_option_for_submission` boolean: Indicates whether the "Not Applicable" option is enabled for submission.
      - `require_remark_for_pass` boolean: Indicates whether a remark is required for a "Pass" result.
      - `dropdown_options` string[]: An array of options for an `InspectionDropdownItem`.
      - `numeric_range_min` number, nullable: The minimum value allowed for an InspectionNumericItem.
      - `numeric_range_max` number, nullable: The maximum value allowed for an InspectionNumericItem.
      - `require_meter_entry_photo_verification` boolean: Indicates whether a photo of the meter is required for verification.
    - `assigned_contacts` ContactMini[]
      - `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.

## 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
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`
- **2025-09-06** `6daa53a03224`: 6 breaking, 4 info
  - the response property `records/items/assigned_contacts/items/default_image_url` became optional for the status `200`
  - the response property `records/items/assigned_contacts/items/id` became optional for the status `200`
  - the response property `records/items/assigned_contacts/items/name` became optional for the status `200`
  - the response property `records/items/reported_by/default_image_url` became optional for the status `200`
  - …6 more

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