> ## 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. # Driver Idling > Returns idling details for a vehicle for each idling activity block that started in the specified period.

No details for idling that occurred inside a private journey are returned. The end date of the idling activity block does not have to be within the specified period. The value specified for the endDate cannot be before startDate and the date range between startDate and endDate cannot be more than 7 days.

Either driverId or groupId must be specified. If driverId is specified, then idling activity for the specified driver is included in the output. If groupId is specified, then idling for all drivers in the specified group is included in the output. Either driverId or groupId can be specified as an input parameter, an error is returned if both are specified.

If there are more than 50 idling activity blocks that match the search criteria, then by default only the first 50 idling blocks are returned. To view details of the other idling activity blocks you will need to specify values for pageSize and pageIndex.
Asset Day Limit
The asset day limit on this endpoint is 50 asset days. You will receive an HTTP status code of 400 (Bad input parameters) and no details will be returned if you exceed this restriction. ## OpenAPI ````yaml https://api.connectedfleet.michelin.com/performance/api-docs get /public/v1/customer/{customerId}/idling/detail/driver openapi: 3.0.1 info: title: Performance description: >- Delivers deeper insights into driver behaviour, fuel efficiency, CO₂ impact and safe driving practices. contact: name: Masternaut url: https://www.masternaut.com email: support@masternautconnect.com version: 124.0.2607160821 servers: - url: https://api.connectedfleet.michelin.com/performance description: Product Server security: - bearerAuth: [] tags: - name: /alert description: Alert history and notification management operations - name: /driver description: Driver Operations - name: /driverbehaviourmetrics description: Driver Behaviour Metrics - name: customers description: Customer Behaviour Metrics - name: /ecoscore description: EcoScore - name: /fuel description: Fuel - name: /idling description: Idling - name: /speeding description: Speeding - name: /tokenInformation description: Token operations - name: /utilisation description: Utilisation - name: /vehicle description: Vehicle management operations paths: /public/v1/customer/{customerId}/idling/detail/driver: get: tags: - /idling summary: Driver Idling description: >- Returns idling details for a vehicle for each idling activity block that started in the specified period.

No details for idling that occurred inside a private journey are returned. The end date of the idling activity block does not have to be within the specified period. The value specified for the endDate cannot be before startDate and the date range between startDate and endDate cannot be more than 7 days.

Either driverId or groupId must be specified. If driverId is specified, then idling activity for the specified driver is included in the output. If groupId is specified, then idling for all drivers in the specified group is included in the output. Either driverId or groupId can be specified as an input parameter, an error is returned if both are specified.

If there are more than 50 idling activity blocks that match the search criteria, then by default only the first 50 idling blocks are returned. To view details of the other idling activity blocks you will need to specify values for pageSize and pageIndex.
Asset Day Limit
The asset day limit on this endpoint is 50 asset days. You will receive an HTTP status code of 400 (Bad input parameters) and no details will be returned if you exceed this restriction. operationId: getPersonIdlingDetails 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 description: >- Start date and time for the search period. Format: yyyy-MM-dd'T'HH:mm:ss in UTC. Required. required: true schema: type: string description: >- Start date and time for the search period. Format: yyyy-MM-dd'T'HH:mm:ss in UTC. Required. format: date-time - name: endDate in: query description: >- End date and time for the search period. Format: yyyy-MM-dd'T'HH:mm:ss in UTC. Required and must be within 7 days of startDate. required: true schema: type: string description: >- End date and time for the search period. Format: yyyy-MM-dd'T'HH:mm:ss in UTC. Required and must be within 7 days of startDate. format: date-time - name: groupId in: query description: >- Group identifier for searching idling episodes by group. Required if not using specific entity ID. required: false schema: type: string description: >- Group identifier for searching idling episodes by group. Required if not using specific entity ID. - name: excludeChildGroups in: query description: Whether to exclude child groups from the search. Defaults to false. required: false schema: type: boolean description: >- Whether to exclude child groups from the search. Defaults to false. - name: idlingDurationSeconds in: query description: >- Minimum idling duration in seconds for filtering. Must be >= 1 if specified. required: false schema: type: integer description: >- Minimum idling duration in seconds for filtering. Must be >= 1 if specified. format: int64 - name: driverId in: query description: >- Driver identifier for searching idling episodes by specific driver. Required if not using groupId. required: false schema: type: string description: >- Driver identifier for searching idling episodes by specific driver. Required if not using groupId. responses: '200': description: Successful operation content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/WithPaginationResultIdlingDetailDto' '400': description: Bad input parameters '404': description: Resource not found components: schemas: WithPaginationResultIdlingDetailDto: 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/IdlingDetailDto' IdlingDetailDto: type: object properties: vehicleId: type: string description: Unique identifier of the vehicle involved in the idling episode. vehicleRegistration: type: string description: Vehicle registration number. vehicleName: type: string description: Name or friendly identifier of the vehicle. driverId: type: string description: Unique identifier of the driver involved in the idling episode. driverName: type: string description: Name of the driver involved in the idling episode. groupId: type: string description: Unique identifier of the group the vehicle belongs to. groupName: type: string description: Name of the group the vehicle belongs to. startTime: type: string description: >- Start date and time of the idling episode. Format: yyyy-MM-dd'T'HH:mm:ss in UTC. format: date-time endTime: type: string description: >- End date and time of the idling episode. Format: yyyy-MM-dd'T'HH:mm:ss in UTC. format: date-time duration: type: integer description: Duration of the idling episode in seconds. format: int64 coordinates: $ref: '#/components/schemas/CoordinateDto' address: type: string description: Address where the idling episode occurred. location: $ref: '#/components/schemas/LocationDto' description: >- Details of an idling episode including timing, location, vehicle, and driver information. CoordinateDto: required: - latitude - longitude type: object properties: longitude: type: number description: Longitude coordinate in decimal degrees. format: double latitude: type: number description: Latitude coordinate in decimal degrees. format: double description: Geographic coordinate with latitude and longitude values. LocationDto: required: - categoryName - name type: object properties: id: pattern: ^[\w]*$ type: string radius: type: number format: double name: type: string categoryName: type: string address: $ref: '#/components/schemas/AddressDto' coordinate: $ref: '#/components/schemas/CoordinateDto' polygon: maxItems: 2147483647 minItems: 3 type: array items: $ref: '#/components/schemas/CoordinateDto' reference: maxLength: 50 minLength: 0 type: string phoneNumber: maxLength: 20 minLength: 0 pattern: ^\+?\d+$ type: string contact: maxLength: 50 minLength: 0 type: string email: maxLength: 50 minLength: 0 type: string notes: maxLength: 140 minLength: 0 type: string AddressDto: required: - city - country - postCode type: object properties: formattedAddress: type: string road: type: string roadNumber: type: string city: maxLength: 50 minLength: 0 type: string postCode: maxLength: 20 minLength: 0 type: string country: maxLength: 50 minLength: 0 type: string roadType: type: string securitySchemes: bearerAuth: type: http scheme: bearer ````