--- title: "Retrieve Issue" method: GET path: "/issues/{id}" tags: ["Issues"] --- # Retrieve Issue `GET /issues/{id}` ## Request - Base URL: `https://secure.fleetio.com/api` - URL: `https://secure.fleetio.com/api/issues/{id}` - Auth: API key in header `Authorization` and API key in header `Account-Token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve the details of an existing Issue. ## Path parameters - `id` string, required ## Query parameters - `includes` 'asset' | 'comments' | 'custom_fields' | 'documents' | 'images' | 'labels' ## Response `200` OK - IssueV2, nullable: An Issue - `id` integer, required - `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. - `number` integer, required: A unique identifier for the Issue. - `summary` string, required: A summary of the Issue. - `description` string, nullable, required: A longer description of the Issue. - `state` 'open' | 'closed' | 'resolved', required: The Issue's current state. - `reported_at` string, date-time, nullable, required: The date and time at which this Issue was reported. - `reported_by` object, nullable, required: The `Contact` ID of the `User` who reported this Issue. - `id` integer - `resolvable_type` 'ServiceEntry' | 'WorkOrder', nullable, required: The type of the object which can resolve this Issue. - `resolved_at` string, date-time, nullable, required: The date and time at which this Issue was resolved. - `resolved_by` object, nullable, required: The `Contact` ID of the `User` that resolved this Issue. - `id` integer - `resolved_note` string, required: Any notes associated with resolving this Issue. - `closed_at` string, date-time, nullable, required: The date and time at which this Issue was closed. - `closed_by` object, nullable, required: The `Contact` ID of the `User` that closed this Issue. - `id` integer - `closed_note` string, required: Any notes associated with closing 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_meter_value` number, float, nullable, required: The 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. - `is_overdue` boolean, required: Indicates whether the Issue is overdue. - `issue_priority` IssuePriority: An Issue Priority represents the priority level of an Issue. - `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 - `alias` string, nullable: Can be used to replace the default priority name provided. Changes how the Issue is displayed throughout Fleetio. - `name` string: The name of the Issue Priority. - `slug` string: Indicates which icon will be shown for the Issue Priority. - `description` string: A description providing more details about the Issue Priority. - `default` boolean: Indicates whether this Issue Priority will be set as default for new `Issues`. - `enabled` boolean: Indicates whether this Issue Priority is currently enabled. - `position` integer: The position or order of the Issue Priority in a list or hierarchy. - `resolvable` object, nullable, required: The ID of the object which can resolve this Issue. - `id` integer - `creation_type` 'manual' | 'workflow', required: Indicates if this Issue was created manually or by a workflow. - `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. - `asset` object, required - `id` integer - `name` string: The name of the asset associated with the Issue. - `image_url_medium` string, nullable: The URL to a medium-sized image of the asset associated with the Issue. - `current_job` object, nullable: The current job for the asset associated with the Issue, if any. - `name` string: The name of the job. - `number` string: The number of the job. - `asset_type` 'Vehicle' | 'Equipment', required: The asset type that has the Issue. - `submitted_inspection_form` object, nullable, required - `id` integer - `fault` object, nullable, required - `id` integer - `watchers_count` integer: The count of watchers associated with the Issue. - `comments_count` integer: The count of `Comments` associated with the Issue. - `images_count` integer: The count of images associated with the Issue. - `documents_count` integer: The count of documents associated with the Issue. - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields). - `labels` object[]: An array of labels associated with the Issue. Can be included in the response by passing `labels` in the `includes` query parameter. - `id` integer - `name` string: The name of the label. - `color` string: The color of the label. ## Other responses - `401`: Request could not be authenticated - `403`: Insufficient permission to perform this operation - `404`: The requested resource could not be located - `500`: Something unexpected happened ## Changes - **2026-06-16** `4098a1c81821`: 2 info - added the new enum value `asset` to the `query` request parameter `includes` - added the optional property `allOf[subschema #2]/asset/current_job` to the response with the `200` status [Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/issues/:id/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)