> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectedfleet.michelin.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Service Due Date
> Returns the service due date for a vehicle. If no parameters are specified, then details for all vehicles with a service due date are returned.
If groupId is specified, then all vehicles in the specified group are included in the output. If vehicleId is specified, then only the specified vehicle is included in the output. Either vehicleId or groupId can be specified as an input parameter, an error is returned if both are specified.
If startDate is specified, then only those vehicles where the service due date is on or after the specified date are returned. If endDate is specified, then only those vehicles where the service due date is on or before the specified end date are returned. If both startDate and endDate are specified, then endDate cannot be before startDate.
If there are more than 20 vehicles to return, then by default only the first 20 vehicles are returned. To view details of the other vehicles you will need to specify values for pageSize and pageIndex.
## OpenAPI
````yaml https://api.connectedfleet.michelin.com/fleet-management/api-docs get /public/v1/customer/{customerId}/vehicle/serviceDate
openapi: 3.0.1
info:
title: Fleet management
description: >-
A comprehensive administration pack enabling full control over fleet
structures, users, drivers, vehicles and operational data.
contact:
name: Masternaut
url: https://www.masternaut.com
email: support@masternautconnect.com
version: 124.0.2607160821
servers:
- url: https://api.connectedfleet.michelin.com/fleet-management
description: Product Server
security:
- bearerAuth: []
tags:
- name: /driver
description: Driver Operations
- name: /group
description: Group operations
- name: /location/category
description: Location category management operations
- name: /location
description: Location management operations
- name: /role
description: Role operations
- name: /tokenInformation
description: Token operations
- name: /user
description: User operations
- name: /maintenance
description: Vehicle maintenance operations
- name: /vehicle
description: Vehicle management operations
paths:
/public/v1/customer/{customerId}/vehicle/serviceDate:
get:
tags:
- /maintenance
- /vehicle
summary: Service Due Date
description: >-
Returns the service due date for a vehicle. If no parameters are
specified, then details for all vehicles with a service due date are
returned.
If groupId is specified, then all vehicles in the
specified group are included in the output. If vehicleId is specified,
then only the specified vehicle is included in the output. Either
vehicleId or groupId can be specified as an input parameter, an error is
returned if both are specified.
If startDate is specified, then
only those vehicles where the service due date is on or after the
specified date are returned. If endDate is specified, then only those
vehicles where the service due date is on or before the specified end
date are returned. If both startDate and endDate are specified, then
endDate cannot be before startDate.
If there are more than 20
vehicles to return, then by default only the first 20 vehicles are
returned. To view details of the other vehicles you will need to specify
values for pageSize and pageIndex.
operationId: searchVehiclesWithServiceDate
parameters:
- name: customerId
in: path
required: true
schema:
type: string
- name: pageIndex
in: query
description: >-
Specifies the pagination page index.
Pages are zero indexed,
i.e. the first page has an index value of zero.
required: false
schema:
type: integer
description: >-
Specifies the pagination page index.
Pages are zero indexed,
i.e. the first page has an index value of zero.
format: int32
- name: pageSize
in: query
description: >-
Specifies the number of items to include on a page.
Must be
specified if pageIndex has been specified.
required: false
schema:
type: integer
description: >-
Specifies the number of items to include on a page.
Must be
specified if pageIndex has been specified.
format: int32
- name: startDate
in: query
required: false
schema:
type: string
format: date-time
- name: endDate
in: query
required: false
schema:
type: string
format: date-time
- name: vehicleId
in: query
required: false
schema:
type: string
- name: groupId
in: query
required: false
schema:
type: string
responses:
'200':
description: Vehicles were successfully returned.
content:
application/json;charset=UTF-8:
schema:
$ref: >-
#/components/schemas/WithPaginationResultVehicleSearchResultWithServiceDateDto
'400':
description: >-
Missing validation on parameters - when endDate is before startDate,
both vehicleId and groupId are specified, or request is null.
'404':
description: No vehicles found for the specified criteria
components:
schemas:
WithPaginationResultVehicleSearchResultWithServiceDateDto:
type: object
properties:
totalPages:
type: integer
description: Total number of pages based on the pageSize.
format: int32
totalCount:
type: integer
description: Total number of items that matched the search parameters.
format: int64
items:
type: array
description: Array of items.
items:
$ref: '#/components/schemas/VehicleSearchResultWithServiceDateDto'
VehicleSearchResultWithServiceDateDto:
type: object
properties:
id:
type: string
groupName:
type: string
groupId:
type: string
make:
type: string
model:
type: string
version:
type: string
serviceDueDate:
type: string
format: date-time
driverId:
type: string
name:
type: string
registration:
type: string
description: Array of items.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
````