For AI agents: the docs index is at https://developer-docs.gomotive.com/llms.txt. Append .md to any documentation page URL to get its markdown version.
V1 and V2 retain their existing inspection-report behavior and do not include spot inspections.
V3 supports spot inspections alongside pre-trip and post-trip inspections. Spot inspections are created through work orders in Motive, not through the public API.
V1 endpoints
Fetch a list of company inspection reports
Endpoint: GET /v1/inspection_reports
Description: Retrieves inspection reports for company vehicles, including inspection details, noted issues, and report status.
Use case: Fleet managers can monitor vehicle inspection history, review reported issues, and identify follow-up needs.
Update an existing inspection report
Endpoint: PUT /v1/inspection_reports/{id}
Description: Updates an existing inspection report.
Use case: Correct report details or update the record when follow-up actions have been completed.
Fetch a report by external ID
Endpoint: GET /v1/inspection_reports/lookup_by_external_id
Description: Retrieves an inspection report using its external ID and integration name.
Use case: Find a report associated with an external system when the integration has attached an external ID to it.
V2 endpoints
Fetch a list of company inspection reports
Endpoint: GET /v2/inspection_reports
Description: Retrieves inspection reports using the V2 response structure. V2 does not include spot inspections.
Use case: Fleet managers can review inspection reports for daily operations and follow-up.
Update an existing inspection report
Endpoint: PUT /v2/inspection_reports/{id}
Description: Updates an existing inspection report using the V2 contract.
Use case: Correct report details or update the record when follow-up actions have been completed.
Fetch a report by external ID
Endpoint: GET /v2/inspection_reports/lookup_by_external_id
Description: Retrieves an inspection report using its external ID and integration name.
Use case: Find a report associated with an external system when the integration has attached an external ID to it.
V3 endpoints
Fetch a list of company inspection reports
Endpoint: GET /v3/inspection_reports
Description: Retrieves inspection reports for company vehicles, including spot inspections as well as pre-trip and post-trip inspections.
Use case: Fleet managers can review inspection reports across these inspection types and identify issues requiring follow-up.
Update an existing inspection report
Endpoint: PUT /v3/inspection_reports/{id}
Description: Updates an existing inspection report using the V3 contract, which supports spot inspections.
Use case: Correct report details or submit supported defect-resolution updates, including for eligible spot-inspection reports.
Fetch a report by external ID
Endpoint: GET /v3/inspection_reports/lookup_by_external_id
Description: Retrieves an inspection report using its external ID and integration name. The integration must have attached the external ID to the report.
Use case: Find a V3 inspection report associated with an external system, including an eligible spot-inspection report.
