List Issues

GET https://secure.fleetio.com/api/v2/issues

Returns a list of Issues belonging to your account.

Request

Query Parameters

start_cursor string

The start cursor for Keyset pagination.

per_page integer

Possible values: >= 2 and <= 100

The number of records per page to return

Default value: 50

filter object

sort object

Responses

application/json

Schema
Example (auto)

Schema

start_cursorstringnullable

The current start cursor of the records returned.

next_cursorstringnullable

The next cursor to retrieve the next page of records.

per_pageinteger

The maxumum number of records returned.

estimated_remaining_countinteger

The number of remaining records including the returned records, up to a maximum of 500.

filtered_by object[]

sorted_by object[]

records object[]

Array [

idintegerrequired

numberstringrequired

A unique identifier for the Issue.

statestringrequired

The Issue's current state.

Possible values: [Open, Closed, Resolved]

created_atdate-timerequired

updated_atdate-timerequired

namestringrequired

The name of the Issue.

descriptionstringnullablerequired

A longer description of the Issue.

reported_atdate-timenullablerequired

The date and time at which the issue was reported.

Example: 2023-03-14T13:46:27-06:00

resolved_atdate-timenullablerequired

The date and time at which the issue was resolved.

Example: 2023-03-14T13:46:27-06:00

resolved_by_idintegernullable

The id of the User who resolved the Issue.

closed_atdate-timenullable

The date and time at which the issue was closed.

Example: 2023-03-14T13:46:27-06:00

closed_by_idintegernullable

The id of the User who closed the Issue.

reopened_atdate-timenullable

The date and time at which the issue was reopened.

Example: 2023-03-14T13:46:27-06:00

reopened_by_idintegernullable

The id of the User who reopened the Issue.

resolvable_idintegernullablerequired

The id of the resolvable_type which can resolve this Issue.

resolvable_typestringnullablerequired

The type of the object which can resolve this Issue.

Possible values: [ServiceEntry, WorkOrder]

due_datedatenullablerequired

The date on which this Issue should be resolved by. Formatted according to ISO-8601 in User's local time zone.

Example: 2023-03-14

due_primary_meter_valuestringnullablerequired

The primary meter value at which this Issue should be resolved by.

due_secondary_meter_valuefloatnullablerequired

The secondary meter value at which this Issue should be resolved by.

overduebooleanrequired

Indicates whether the Issue is overdue.

asset_typestringrequired

The type of asset this Issue applies to.

Possible values: [Vehicle, Equipment]

submitted_inspection_form_idintegernullablerequired

The id of the associated SubmittedInspectionForm, if any.

fault_idintegernullablerequired

The id of the associated Fault if any.

external_idstringnullablerequired

The external ID for this Issue.

watchers_countintegerrequired

The count of watchers for this Issue.

comments_countintegerrequired

The count of comments for this Issue.

documents_countintegerrequired

The count of documents for this Issue.

images_countintegerrequired

The count of images for this Issue.

custom_fieldsobjectnullable

*Full details on working with Custom Fields here.

vehicle object

equipment objectnullable

reported_by objectnullable

fault_rule object

labels object[]

assigned_contacts object[]

]

{
  "start_cursor": "string",
  "next_cursor": "string",
  "per_page": 0,
  "estimated_remaining_count": 0,
  "filtered_by": [
    {
      "reported_by_id": {
        "eq": "string"
      }
    },
    {
      "vehicle_id": {
        "eq": "string"
      }
    },
    {
      "equipment_id": {
        "eq": "string"
      }
    },
    {
      "labels": {
        "include": "string"
      }
    },
    {
      "state": {
        "eq": "string"
      }
    },
    {
      "due_date": {
        "eq": "string"
      }
    },
    {
      "resolved_at": {
        "lt": "string"
      }
    },
    {
      "reported_at": {
        "lt": "string"
      }
    },
    {
      "created_at": {
        "lt": "string"
      }
    },
    {
      "updated_at": {
        "lt": "string"
      }
    },
    {
      "assigned_contact_ids": {
        "include": "string"
      }
    },
    {
      "closed_at": {
        "lt": "string"
      }
    },
    {
      "reopened_at": {
        "lt": "string"
      }
    }
  ],
  "sorted_by": [
    {
      "id": "asc"
    },
    {
      "due_date": "asc"
    },
    {
      "updated_at": "asc"
    },
    {
      "created_at": "asc"
    },
    {
      "resolved_at": "asc"
    },
    {
      "reported_at": "asc"
    }
  ],
  "records": [
    {
      "id": 0,
      "number": "string",
      "state": "Open",
      "created_at": "2024-07-29T15:51:28.071Z",
      "updated_at": "2024-07-29T15:51:28.071Z",
      "name": "string",
      "description": "string",
      "reported_at": "2023-03-14T13:46:27-06:00",
      "resolved_at": "2023-03-14T13:46:27-06:00",
      "resolved_by_id": 0,
      "closed_at": "2023-03-14T13:46:27-06:00",
      "closed_by_id": 0,
      "reopened_at": "2023-03-14T13:46:27-06:00",
      "reopened_by_id": 0,
      "resolvable_id": 0,
      "resolvable_type": "ServiceEntry",
      "due_date": "2023-03-14",
      "due_primary_meter_value": "string",
      "due_secondary_meter_value": 0,
      "overdue": true,
      "asset_type": "Vehicle",
      "submitted_inspection_form_id": 0,
      "fault_id": 0,
      "external_id": "string",
      "watchers_count": 0,
      "comments_count": 0,
      "documents_count": 0,
      "images_count": 0,
      "custom_fields": {},
      "vehicle": {
        "id": 0,
        "name": "string",
        "color": "string",
        "license_plate": "string",
        "vin": "string",
        "year": "string",
        "make": "string",
        "model": "string",
        "trim": "string",
        "registration_expiration_month": 0,
        "registration_state": "string",
        "default_image_url_small": "string"
      },
      "equipment": {
        "id": 0,
        "name": "string",
        "brand": "string",
        "model": "string",
        "serial_number": "string"
      },
      "reported_by": {
        "id": 0,
        "email": "string",
        "name": "string",
        "group_id": 0,
        "default_image_url": "string"
      },
      "fault_rule": {
        "id": 0,
        "created_at": "2023-03-14T13:46:27-06:00",
        "updated_at": "2023-03-14T13:46:27-06:00",
        "account_id": 0,
        "code": "string",
        "description": "string",
        "priority_handling": "off",
        "name": "string"
      },
      "labels": [
        {
          "id": 0,
          "name": "string"
        }
      ],
      "assigned_contacts": [
        {
          "id": 0,
          "email": "string",
          "name": "string",
          "group_id": 0,
          "default_image_url": "string"
        }
      ]
    }
  ]
}

The format or parameters of the request was invalid

application/json

Schema
Example (auto)

Schema

errors object

{
  "errors": {}
}

Request could not be authenticated

application/json

Schema
Example (auto)

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

A human-readable explanation specific to this occurrence of the problem.

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

Something unexpected happened

application/json

Schema
Example (auto)

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

A human-readable explanation specific to this occurrence of the problem.

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

Authorization: Authorization

name: Authorizationtype: apiKeyin: headerdescription: Prefix the value with "Token", for example: "Token 76cbe06c49a64".
You can generate a new API key [here](https://secure.fleetio.com/api_keys).

name: Account-Tokentype: apiKeyin: headerdescription: You can find your Account-Token [here](https://secure.fleetio.com/api_keys)

CURL

curl -L 'https://secure.fleetio.com/api/v2/issues' \
-H 'Accept: application/json' \
-H 'Authorization: Token <Authorization>' \
-H 'Account-Token: <Authorization>'

ResponseClear

Click the Send API Request button above and see the response here!

List Issues

https://secure.fleetio.com/api/v2/issues

Request​

Query Parameters

Responses​

Authorization: Authorization

Request

Responses