Retrieve Inspection Form
Returns a single Inspection Form.
Path Parameters
- id string required
Possible values: Value must match regular expression
^[0-9]+$
The id of the relevant record
- 200
- 401
- 404
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
- id integer
The ID of the Inspection Form.
- title string
The title or name of the Inspection Form.
- description string
A brief description or explanation of the Inspection Form's purpose or requirements.
- updated_at date-time
The date and time when the Inspection Form was last updated. Formatted according to ISO-8601 in UTC.
- archived_at date-time
The date and time when the Inspection Form was archived, if applicable.
- require_live_photo boolean
Indicates whether live photos are required as part of the inspection.
- version integer
The version number of the Inspection Form.
- current_form_version_id integer
The ID of the current version of the Inspection Form.
- workflow_assign_user_to_vehicle_enabled boolean
Indicates whether the workflow allows assigning
Users
toVehicles
for inspections. inspection_items object[]
id integerThe ID of the Inspection Item.
inspection_form_version_id integerThe ID of the Inspection Form version to which this item belongs.
account_id integerThe Fleetio Account ID associated with this Inspection Item.
type stringPossible values: [
InspectionDateItem
,InspectionDatetimeItem
,InspectionDropdownItem
,InspectionFreeTextItem
,InspectionMeterEntryItem
,InspectionNumericItem
,InspectionPassFailItem
,InspectionPhotoItem
,InspectionSectionItem
,InspectionSignatureItem
,InspectionSingleCheckboxItem
]The type or category of the Inspection Item.
label stringThe label or name of the Inspection Item.
short_description stringA brief description of the Inspection Item.
instructions stringInstructions or guidance for completing the Inspection Item.
required booleanIndicates whether this Inspection Item is required to be completed.
position integerThe position or order of the Inspection Item within the form.
require_remark_for_fail booleanIndicates whether a remark is required for a "Fail" result.
pass_label stringThe label for a "Pass" result.
fail_label stringThe label for a "Fail" result.
reuse_pass_fail_label booleanIndicates whether to reuse pass/fail labels for this item.
require_secondary_meter_if_one_exists booleanIndicates whether a Secondary Meter Entry is required, if a secondary meter is in use.
created_at date-timeThe date and time when the Inspection Item was created.
updated_at date-timeThe date and time when the Inspection Item was last updated.
version_key stringThe version key associated with the Inspection Item.
na_label stringThe label for "Not Applicable" option.
enable_na_option_for_submission booleanIndicates whether the "Not Applicable" option is enabled for submission.
require_remark_for_pass booleanIndicates whether a remark is required for a "Pass" result.
dropdown_options string[]An array of options for an
InspectionDropdownItem
.numeric_range_min numberThe minimum value allowed for an InspectionNumericItem.
numeric_range_max numberThe maximum value allowed for an InspectionNumericItem.
require_meter_entry_photo_verification booleanIndicates whether a photo of the meter is required for verification.
{
"id": 20,
"title": "Driver Vehicle Inspection Report (Full)",
"description": "As required by the US Dept. of Transportation (DOT) Federal Motor Carrier Safety Regulations in FMCSA 396.11.a.1",
"updated_at": "2023-09-20T08:46:11Z",
"archived_at": "2024-11-21",
"require_live_photo": false,
"version": 8,
"current_form_version_id": 50,
"workflow_assign_user_to_vehicle_enabled": false,
"inspection_items": [
{
"id": 88,
"inspection_form_version_id": 50,
"account_id": 18,
"type": "InspectionDateItem",
"label": "Odometer Reading",
"short_description": "Meter Entry Inspection Item.",
"instructions": "Complete this Inspection Item by entering the odometer reading.",
"required": true,
"position": 1,
"require_remark_for_fail": false,
"pass_label": "Pass",
"fail_label": "Fail",
"reuse_pass_fail_label": true,
"require_secondary_meter_if_one_exists": true,
"created_at": "2023-09-20T11:00:19.952-05:00",
"updated_at": "2016-07-27T20:38:56.454-05:00",
"version_key": "6552b703-e366-420d-873a-2a4ca0f73acc",
"na_label": "N/A",
"enable_na_option_for_submission": false,
"require_remark_for_pass": false,
"dropdown_options": [
"string"
],
"numeric_range_min": 3,
"numeric_range_max": 5,
"require_meter_entry_photo_verification": false
}
]
}
Request could not be authenticated
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
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.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
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"
}
The requested resource could not be located
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
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.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
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 (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
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.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
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"
}