Retrieve Submitted Inspection Form
Retrieve the details of an existing Submitted Inspection Form.
Submitting inspection forms through the API is not currently supported.
Path Parameters
- id string required
Possible values: Value must match regular expression
^[0-9]+$
The id of the relevant record
- 200
- 401
- 403
- 404
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
- id integer
Possible values:
>= 1
- started_at date
The date and time at which this Inspection Form was started.
- submitted_at date
The date and time at which this Inspection Form was submitted.
- date string
The date on which this Inspection Form was submitted, formatted as "Mon DD, YYYY"
- failed_items integer
The number of failed items on this Inspection Form.
- vehicle_id integer
Possible values:
>= 1
- starting_latitude float
The latitude at which this Inspection Form was started.
- starting_longitude float
The longitude at which this Inspection Form was started.
- submitted_latitude float
The latitude at which this Inspection Form was submitted.
- submitted_longitude float
The longitude at which this Inspection Form was submitted.
- duration string
The duration of time in words (eg; 15 minutes, about 1 hour) between when this Inspection Form was started and when it was submitted.
inspection_form object
id integerPossible values:
>= 1
title stringThe title of the Inspection Form.
description stringThe description of the Inspection Form.
- contact_id NullableId
Possible values:
>= 1
- user string
The full name of the User that submitted this Inspection Form.
submitted_inspection_items object[]
result object
This object contains the result of the Submitted Inspection Item. The key:value pair(s) returned vary depending on the type of Inspection Item.
id integerPossible values:
>= 1
comments_count integerThe number of
Comments
related to this Inspection Item.images_count integerThe number of Images related to this Inspection Item.
submitted_inspection_form_id integerPossible values:
>= 1
latitude floatThe latitude at which this Inspection Item was submitted.
longitude floatThe longitude at which this Inspection Item was submitted.
inspection_item object
label stringThe label or name of the Inspection Item.
type stringPossible values: [
InspectionDateItem
,InspectionDatetimeItem
,InspectionDropdownItem
,InspectionFreeTextItem
,InspectionMeterEntryItem
,InspectionNumericItem
,InspectionPassFailItem
,InspectionPhotoItem
,InspectionSectionItem
,InspectionSignatureItem
,InspectionSingleCheckboxItem
]The type or category of the Inspection Item.
fail_label stringThe label for a "Fail" result.
pass_label stringThe label for a "Pass" result.
na_label stringThe label for a "Not Applicable" result.
dropdown_options object[]
An array of options for an
InspectionDropdownItem
.label stringThe label or name of the Inspection Item.
position integerThe position or order of the Inspection Item within the form.
fail_if_chosen booleanIndicates whether the inspection should fail if this item is chosen.
numeric_range_max floatThe maximum value for an
InspectionNumericItem
.numeric_range_min floatThe minimum value for an
InspectionNumericItem
.requirement_settings objectA dynamically generated list of settings describing required items as part of the inspection form.
- comments_count integer
The number of
Comments
on this Inspection Form. - images_count integer
The number of images attached to this Inspection Form.
{
"id": 0,
"started_at": "2023-03-14",
"submitted_at": "2023-03-14",
"date": "string",
"failed_items": 0,
"vehicle_id": 0,
"starting_latitude": 0,
"starting_longitude": 0,
"submitted_latitude": 0,
"submitted_longitude": 0,
"duration": "string",
"inspection_form": {
"id": 0,
"title": "string",
"description": "string"
},
"contact_id": 0,
"user": "string",
"submitted_inspection_items": [
{
"result": {},
"id": 0,
"comments_count": 0,
"images_count": 0,
"submitted_inspection_form_id": 0,
"latitude": 0,
"longitude": 0,
"inspection_item": {
"label": "string",
"type": "InspectionDateItem",
"fail_label": "string",
"pass_label": "string",
"na_label": "string",
"dropdown_options": [
{
"label": "string",
"position": 0,
"fail_if_chosen": true
}
],
"numeric_range_max": 0,
"numeric_range_min": 0,
"requirement_settings": {}
}
}
],
"comments_count": 0,
"images_count": 0
}
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"
}
Insufficient permission to perform this operation
- 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"
}