--- title: "List Submitted Inspection Forms" method: GET path: "/submitted_inspection_forms" tags: ["Submitted Inspection Forms"] --- # List Submitted Inspection Forms `GET /submitted_inspection_forms` ## Request - Base URL: `https://secure.fleetio.com/api` - URL: `https://secure.fleetio.com/api/submitted_inspection_forms` - 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) Returns a list of submitted inspection forms. :::info Submitting inspection forms through the API is not currently supported. ::: ## Query parameters - `start_cursor` string - `per_page` integer - `filter` object - `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 - `submitted_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - `inspection_form_id` EqFilter - `eq` string, required - `inspection_form_version_id` EqFilter - `eq` string, required - `inspection_form_title` LikeFilter - `like` string, required - `vehicle_id` EqFilter - `eq` string, required - `user_id` EqFilter - `eq` string, required - `sort` object - `created_at` 'asc' | 'desc' - `submitted_at` 'asc' | 'desc' - `updated_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 - `inspection_form_id` EqFilter - `eq` string, required - object - `inspection_form_version_id` EqFilter - `eq` string, required - object - `inspection_form_title` LikeFilter - `like` string, required - object - `vehicle_id` EqFilter - `eq` string, required - object - `user_id` EqFilter - `eq` string, required - `sorted_by` union[]: The sorts applied to the returned record set. - union - object - `failed_items` 'asc' | 'desc' - object - `submitted_at` 'asc' | 'desc' - object - `updated_at` 'asc' | 'desc' - object - `id` 'asc' | 'desc' - `records` SubmittedInspectionFormSummary[] - `id` integer, required - `started_at` string, date-time, required: The date and time at which this Inspection Form was started. - `submitted_at` string, date-time, required: The date and time at which this Inspection Form was submitted. - `date` string, date, required: The date on which this Inspection Form was submitted - `failed_items` number, required: The number of failed items on this Inspection Form. - `starting_latitude` number, nullable, required: The latitude at which this Inspection Form was started. - `starting_longitude` number, nullable, required: The longitude at which this Inspection Form was started. - `submitted_latitude` number, nullable, required: The latitude at which this Inspection Form was submitted. - `submitted_longitude` number, nullable, required: The longitude at which this Inspection Form was submitted. - `inspection_form` object, required - `id` integer - `title` string: The title of the Inspection Form. - `description` string: The description of the Inspection Form. - `user` 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. - `vehicle` VehicleMini, required: A Vehicle - `id` integer, required - `name` string, required: This vehicle's name. - `color` string, nullable: The color of this Vehicle. - `license_plate` string, nullable: The license plate number of this Vehicle. - `vin` string, nullable: The Vehicle Identification Number of this Vehicle. - `year` string, nullable: This Vehicle's model year. - `make` string, nullable: The name of this Vehicle's manufacturer. - `model` string, nullable: The name of the model of this Vehicle. - `trim` string, nullable: The trim level of this Vehicle. - `registration_expiration_month` integer, nullable: The month in which this Vehicle's registration expires. - `registration_state` string, nullable: The state, province, or territory in which this Vehicle is registered. - `default_image_url_small` string, nullable: The URL of a small-sized version of the default image for this Vehicle. - `work_order` object - `id` integer - `number` integer ## 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` - **2026-06-16** `4098a1c81821`: 1 info - added the optional property `records/items/work_order` to the response with the `200` status - **2025-09-06** `6daa53a03224`: 3 breaking, 2 info - the response property `records/items/user/default_image_url` became optional for the status `200` - the response property `records/items/user/id` became optional for the status `200` - the response property `records/items/user/name` became optional for the status `200` - added the optional property `records/items/user/employee` to the response with the `200` status - …1 more [Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/submitted_inspection_forms/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)